> ## Documentation Index > Fetch the complete documentation index at: https://docs.outboundlegal.com/llms.txt > Use this file to discover all available pages before exploring further. # List clients > Your clients, oldest change first. Keep passing `next_cursor` back as `cursor` until it's `null`. A change shows up here about a minute after it's saved. ## OpenAPI ````yaml /api/openapi.json get /clients openapi: 3.1.0 info: title: OutboundLegal API version: 1.0.0 description: >- Connect Zapier or your own tools to OutboundLegal: add and update your clients, mark a case settled, and send our prospects to your CRM as cold leads. Every request needs an API key from Settings → Integrations → API keys, sent as `Authorization: Bearer obl_…`. Limit: 120 requests per minute per key. servers: - url: https://app.outboundlegal.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Account description: Which account a key belongs to. - name: Clients description: Your firm's own clients (not crash prospects). - name: Prospects description: Crash prospects in your counties, as cold leads. Digital bundle only. paths: /clients: get: tags: - Clients summary: List clients description: >- Your clients, oldest change first. Keep passing `next_cursor` back as `cursor` until it's `null`. A change shows up here about a minute after it's saved. operationId: listClients parameters: - name: updated_since in: query required: false description: >- Only clients changed at or after this time (ISO 8601, e.g. `2026-10-01T00:00:00Z`). schema: type: string format: date-time - name: limit in: query required: false description: How many clients per page, 1 to 100. schema: type: integer minimum: 1 maximum: 100 default: 100 - name: cursor in: query required: false description: >- The `next_cursor` from the previous page. Treat it as an opaque string. schema: type: string responses: '200': description: One page of clients. content: application/json: schema: type: object required: - data - next_cursor properties: data: type: array items: $ref: '#/components/schemas/Client' next_cursor: type: - string - 'null' description: >- Pass this as `cursor` for the next page. `null` means you have everything. '400': $ref: '#/components/responses/InvalidRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/Internal' components: schemas: Client: type: object required: - id - first_name - last_name - address_line1 - address_line2 - city - state - zip - email - phone - case_type - opened_on - settled_on - source - external_id - do_not_mail - created_at - updated_at properties: id: type: string format: uuid first_name: type: - string - 'null' last_name: type: - string - 'null' address_line1: type: - string - 'null' address_line2: type: - string - 'null' city: type: - string - 'null' state: type: - string - 'null' zip: type: - string - 'null' email: type: - string - 'null' phone: type: - string - 'null' case_type: type: - string - 'null' opened_on: type: - string - 'null' format: date settled_on: type: - string - 'null' format: date source: type: string enum: - manual - csv - prospect - api description: >- How the client was first added: typed in, CSV import, Mark as client, or the API. external_id: type: - string - 'null' do_not_mail: type: boolean created_at: type: string format: date-time updated_at: type: string format: date-time Error: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' ErrorBody: type: object required: - code - message properties: code: type: string enum: - unauthorized - forbidden - not_enabled - bundle_required - rate_limited - invalid_request - not_found - conflict - cursor_stale - internal description: Branch on this. It doesn't change. message: type: string description: A sentence a person can read. It may change. responses: InvalidRequest: description: >- `invalid_request`: a parameter or the body isn't right. The message says what to fix. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: invalid_request message: limit must be a whole number from 1 to 100. Unauthorized: description: >- `unauthorized`: no key, a badly formed key, or a key that isn't valid or was revoked. headers: WWW-Authenticate: description: >- Sent when the key is missing or badly formed: `Bearer realm="OutboundLegal"`. schema: type: string content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: unauthorized message: 'Send your API key as: Authorization: Bearer obl_…' Forbidden: description: >- `forbidden`: the account's access is suspended, or the key belongs to a view-only login. `not_enabled`: the API isn't turned on for this account yet. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: not_enabled message: The API isn't turned on for this account yet. RateLimited: description: >- `rate_limited`: more than 120 requests in a minute with this key. Wait the number of seconds in `Retry-After`, then try again. headers: Retry-After: description: Seconds to wait before trying again. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: rate_limited message: Too many requests. The limit is 120 per minute per key. Internal: description: '`internal`: something went wrong on our side. Try again shortly.' content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: >- An API key from Settings → Integrations → API keys. Keys look like `obl_` followed by 43 letters, numbers, `-` or `_`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.