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

# List sourcings

> Returns paginated sourcings for the authenticated workspace.

<Card title="First time? Set up Authentication" icon="key" href="/authentication">
  Learn how to authenticate your API requests with your API key.
</Card>

Returns sourcings visible to the API key user. For now, each item only includes the sourcing id and display name.

## Query parameters

<ParamField query="page" type="integer" default="0">
  Zero-based page index.
</ParamField>

<ParamField query="pageSize" type="integer" default="8">
  Page size (max 50).
</ParamField>

<ParamField query="ownership" type="string" default="mine">
  `mine` or `all`.
</ParamField>

<ParamField query="status" type="string" default="in-progress">
  `in-progress` or `closed`.
</ParamField>

## Response

When `success` is `true`, `data` contains:

* `sourcings` — list of sourcing references:
  * `sourcingId`
  * `name`
* `pagination` — `page`, `pageSize`, `total`, `hasNextPage`

```json theme={null}
{
  "success": true,
  "data": {
    "sourcings": [
      {
        "sourcingId": "sourcing_123",
        "name": "Senior Backend Engineer"
      }
    ],
    "pagination": {
      "page": 0,
      "pageSize": 8,
      "total": 1,
      "hasNextPage": false
    }
  }
}
```

## Errors

| Code               | HTTP |
| ------------------ | ---- |
| `validation_error` | 400  |
| `internal_error`   | 500  |

```bash theme={null}
curl -G https://app.kalent.ai/api/v1/sourcings \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "page=0" \
  --data-urlencode "pageSize=8" \
  --data-urlencode "ownership=mine" \
  --data-urlencode "status=in-progress"
```