> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get source connection check

> Retrieve the most recent connection check for the source connector.

## Path parameters

<ParamField path="source_id" type="string" required>
  The unique identifier of the source connector.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  Unique identifier for the connection check.
</ResponseField>

<ResponseField name="status" type="string" required>
  Connection check status. One of: `SCHEDULED`, `SUCCESS`, `FAILURE`.
</ResponseField>

<ResponseField name="reason" type="string">
  Failure reason, if applicable.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp when the check was initiated.
</ResponseField>

<ResponseField name="reported_at" type="string">
  ISO 8601 timestamp when the check result was reported.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url "${UNSTRUCTURED_API_URL}/api/v1/sources/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d/connection-check" \
    --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"
  ```

  ```python Python SDK theme={null}
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import GetConnectionCheckSourcesRequest

  client = UnstructuredClient(
      api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
      server_url=os.getenv("UNSTRUCTURED_API_URL"),
  )

  response = client.sources.get_source_connection_check(
      request=GetConnectionCheckSourcesRequest(
          source_id="a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
      )
  )
  print(response)
  ```

  ```python Python SDK (async) theme={null}
  import asyncio
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import GetConnectionCheckSourcesRequest

  async def get_source_connection_check():
      client = UnstructuredClient(
          api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
          server_url=os.getenv("UNSTRUCTURED_API_URL"),
      )
      response = await client.sources.get_source_connection_check_async(
          request=GetConnectionCheckSourcesRequest(
              source_id="a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
          )
      )
      print(response)

  asyncio.run(get_source_connection_check())
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "c2b3a4d5-6e7f-8a9b-0c1d-2e3f4a5b6c7d",
    "status": "SUCCESS",
    "reason": null,
    "created_at": "2026-01-01T00:00:00Z",
    "reported_at": "2026-01-01T00:00:05Z"
  }
  ```
</ResponseExample>