> ## Documentation Index > Fetch the complete documentation index at: https://docs.leen.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Connections > List all the connections for a given Organization. ## OpenAPI ````yaml get /provisioning/organizations/{organization_id}/connections openapi: 3.1.0 info: title: Leen Security API version: 0.0.1 servers: - description: Production API (US) url: https://api.leen.dev/v1 - description: Production API (EU) url: https://api.eu-c1.leen.dev/v1 - description: Production API (APAC) url: https://api.ap-se2.leen.dev/v1 security: [] paths: /provisioning/organizations/{organization_id}/connections: get: tags: - provisioning summary: List Connections description: List all the connections for a given Organization. operationId: list_connections parameters: - in: path name: organization_id required: true schema: format: uuid title: Organization Id type: string - in: query name: limit required: false schema: default: 100 minimum: 0 title: Limit type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 title: Offset type: integer - description: Equality Filter for Connection id in: query name: id required: false schema: anyOf: - format: uuid type: string - type: 'null' description: Equality Filter for Connection id title: Id - description: Equality Filter for Connection identifier in: query name: identifier required: false schema: anyOf: - type: string - type: 'null' description: Equality Filter for Connection identifier title: Identifier - description: Equality Filter for Connection vendor in: query name: vendor required: false schema: anyOf: - $ref: '#/components/schemas/ConnectionVendorEnum' - type: 'null' description: Equality Filter for Connection vendor title: Vendor - description: Equality Filter for Connection health status (HEALTHY/UNHEALTHY) in: query name: healthStatus required: false schema: anyOf: - $ref: '#/components/schemas/ConnectionHealthStatusEnum' - type: 'null' description: Equality Filter for Connection health status (HEALTHY/UNHEALTHY) examples: - HEALTHY - UNHEALTHY title: Healthstatus - description: Filter Connection by health status name, comma separated in: query name: healthStatusCodes required: false schema: anyOf: - type: string - type: 'null' description: Filter Connection by health status name, comma separated examples: - UNAUTHORIZED,EXECUTION_TIMEOUT title: Healthstatuscodes responses: '200': content: application/json: schema: $ref: >- #/components/schemas/OffsetPaginatedResponse_ConnectionRespModel_ description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - API-Key: [] components: schemas: ConnectionVendorEnum: enum: - AIKIDO - ARNICA - AWS_ACCESS_ANALYSER - AWS_GUARDDUTY - AWS_INSPECTOR2 - AWS_SECURITYHUB - BIT_SIGHT - BLACK_DUCK_COVERITY - BLACK_DUCK_SCA - BLACK_KITE - CHECKMARX - CROWDSTRIKE - CROWDSTRIKE_SPOTLIGHT - GITHUB - GITLAB - HEELER - INSIGHTVM - JIRA - LACEWORK_CSPM - MEND - MS_DEFENDER_CLOUD - MS_DEFENDER_ENDPOINT - MS_DEFENDER_VMS - MS_DEFENDER_VMS_GCC_HIGH - MS_ENTRA - MS_INTUNE - OKTA_IDP - ORCA - PROCESSUNITY - PROOFPOINT_TAP - QUALYS - SECURITY_SCORECARD - SEMGREP - SENTINELONE - SENTINELONE_VMS - SERVICENOW - SERVICENOW_ITSM - SERVICENOW_VR - SNYK - SOCKET - SONARQUBE - TANIUM_VMS - TENABLE - UPWIND - WIZ_CODE - WIZ_CSPM - WIZ_VMS title: ConnectionVendorEnum type: string ConnectionHealthStatusEnum: enum: - HEALTHY - UNHEALTHY - INITIALIZING title: ConnectionHealthStatusEnum type: string OffsetPaginatedResponse_ConnectionRespModel_: properties: count: description: Number of items return in the response title: Count type: integer items: description: The records on this page. items: $ref: '#/components/schemas/ConnectionRespModel' title: Items type: array total: anyOf: - type: integer - type: 'null' description: Total number of items that can be returned title: Total required: - count - items title: OffsetPaginatedResponse[ConnectionRespModel] type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object ConnectionRespModel: properties: created_at: description: When the connection was created. format: date-time title: Created At type: string direction: $ref: '#/components/schemas/ConnectionDirectionEnum' default: SOURCE description: >- Which way data moves. `SOURCE` reads from the vendor; the destination kinds write to it, and are what a push or pull integration uses. health: $ref: '#/components/schemas/ConnectionHealthRespModel' description: >- Whether the connection is working, and who has to act if it is not -- a revoked credential is yours to fix, a vendor outage is not. id: description: >- Leen's identifier for this connection. Pass it as `connection_id` when reading data. format: uuid title: Id type: string identifier: anyOf: - type: string - type: 'null' description: >- Your own reference for this connection, set when it was created. Leen does not interpret it; it is here so you can match a connection to a record in your system. title: Identifier is_active: description: >- Whether scheduled syncing runs. Separate from `state`: a connection can be `ACTIVE` with syncing switched off. title: Is Active type: boolean last_token_issued_at: anyOf: - format: date-time type: string - type: 'null' description: >- Pull destinations only: latest access-token mint time across active secrets. Used as a freshness proxy since these connections never sync. title: Last Token Issued At oauth2_authorize_url: anyOf: - type: string - type: 'null' description: >- Where to send the user to authorise this connection, for vendors that use OAuth2. Null once authorisation is complete, and for every vendor that authenticates another way. title: Oauth2 Authorize Url organization_id: description: The organization this connection belongs to. format: uuid title: Organization Id type: string pull_destination_health: anyOf: - enum: - HEALTHY - STALE type: string - type: 'null' description: >- Pull destinations only: HEALTHY if a token was minted within the staleness window, STALE otherwise (including if none was ever minted). title: Pull Destination Health refresh_interval_secs: description: Seconds between scheduled syncs. Defaults to 14400 -- four hours. title: Refresh Interval Secs type: integer source_connection_id: anyOf: - format: uuid type: string - type: 'null' description: >- For a destination connection, the source whose data it forwards. Null on a source connection. title: Source Connection Id state: $ref: '#/components/schemas/ConnectionStateEnum' description: >- Lifecycle state. `PENDING` until credentials are accepted, then `ACTIVE`. `PAUSED` stops syncing without discarding anything; `DELETED` is a soft delete and its data is no longer readable. timeout_secs: description: >- How long a single sync may run before it is abandoned. Defaults to 3600. title: Timeout Secs type: integer updated_at: description: When any field on the connection last changed. format: date-time title: Updated At type: string vendor: description: >- The tool this connection reads from or writes to, e.g. `SNYK`, `QUALYS`. title: Vendor type: string required: - id - vendor - is_active - refresh_interval_secs - timeout_secs - organization_id - state - created_at - updated_at - health title: Connection type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object ConnectionDirectionEnum: enum: - SOURCE - PUSH_DESTINATION - PULL_DESTINATION title: ConnectionDirectionEnum type: string ConnectionHealthRespModel: properties: description: title: Description type: string details: anyOf: - items: $ref: '#/components/schemas/ConnectionHealthUnauthorizedDetail' type: array - type: 'null' title: Details name: $ref: '#/components/schemas/ConnectionHealthStatusName' resolution_owner: $ref: '#/components/schemas/ResolutionOwner' status: $ref: '#/components/schemas/ConnectionHealthStatusEnum' required: - name - status - description - resolution_owner title: ConnectionHealthRespModel type: object ConnectionStateEnum: enum: - PENDING - ACTIVE - PAUSED - DELETED - HARD_DELETED title: ConnectionStateEnum type: string ConnectionHealthUnauthorizedDetail: properties: data_export_type: anyOf: - $ref: '#/components/schemas/DataExportTypesEnum' - type: 'null' endpoint: title: Endpoint type: string required: - endpoint title: ConnectionHealthUnauthorizedDetail type: object ConnectionHealthStatusName: enum: - HEALTHY - INITIALIZING - UNAUTHORIZED - CONNECTION_RECONFIGURATION_REQUIRED - VENDOR_CLIENT_ERROR - VENDOR_SERVER_ERROR - EXECUTION_TIMEOUT - RATE_LIMIT_EXCEEDED - INTERNAL_ERROR title: ConnectionHealthStatusName type: string ResolutionOwner: enum: - LEEN - CUSTOMER - VENDOR title: ResolutionOwner type: string DataExportTypesEnum: enum: - alerts - compliances - compliance_findings - config_users - cspm_alerts - device_groups - device_policies - devices - idp - idp_alerts - idp_audit_logs - idp_policies - issues - organization_identities - sast_issues - sca_issues - vms_scan_configs - vulnerabilities - resources - vulnerability_findings_v2 - grc_entity - grc_control - grc_evidence - grc_assessment_question - grc_assessment - tprm - tprm_company - tprm_finding - findings - itsm_users - itsm_groups - itsm_projects - itsm_tickets - itsm_attachments - itsm_comments - applications - siem_events title: DataExportTypesEnum type: string securitySchemes: API-Key: in: header name: X-API-KEY type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.