> ## Documentation Index > Fetch the complete documentation index at: https://docs.slate.inc/llms.txt > Use this file to discover all available pages before exploring further. # List creditors > Returns the creditors managed by the caller's owner. ## OpenAPI ````yaml /api-reference/accounts/openapi.yaml get /v1/creditors openapi: 3.0.0 info: title: Accounts API (DRAFT) version: 0.0.1 contact: name: Slate API Support email: api-support@slate.inc url: https://slate.inc description: >- **DRAFT. Shapes, names, and field sets may change before this is finalized** The Accounts API is how an owner keeps Slate's view of its accounts in sync. An **account** is the primary data entity that Slate services against, mapping to the originating account that the debt is associated with. **Two identifiers.** Slate assigns each account a stable UUID, `accountId` — this is the canonical id and the key for every read and targeted update. You also carry your own identifier for the account, `crid` (the account number in your system), which is unique within your organization (`owner`). You do not know Slate's `accountId` until the account has been created, so the first write is an **upsert** keyed on your `crid`; the response returns the assigned `accountId`, which you use from then on (and can re-resolve any time via `GET /v1/accounts?crid=...`). **Upsert.** `POST /v1/accounts` idempotently creates the account if new or updates it if one already exists for your `(owner, crid)`. Send the account's current state as a full snapshot — this is how a daily inventory feed keeps Slate in sync. Targeted updates use a partial `PATCH /v1/accounts/{accountId}` — send only the fields that changed (balance, status, placement, legal, …) — for owners that prefer not to resend the whole account. **Scoping & auth.** Every request is scoped to a single `owner`; `crid` is unique only within an owner. List requests take a required `owner` query parameter (which your token must be authorized to read); writes are scoped to the single `owner` on your bearer token. **Money.** All monetary amounts are **US dollars with two decimal places**, sent and returned as decimal **strings** (e.g. `"1250.75"`) to avoid floating-point rounding. Do not send minor units (cents) or bare JSON numbers. servers: - url: https://api.slate.inc/accounts description: Production - url: https://api.uat.slate.inc/accounts description: UAT (staging) security: - bearerAuth: [] paths: /v1/creditors: get: summary: List creditors description: Returns the creditors managed by the caller's owner. operationId: listCreditors parameters: - $ref: '#/components/parameters/Owner' - name: orderBy in: query required: false schema: type: string default: name enum: - name - name: orderDirection in: query required: false schema: $ref: '#/components/schemas/OrderDirection' - name: limit in: query required: false schema: type: integer default: 100 minimum: 1 maximum: 500 - name: cursor in: query required: false description: >- Opaque cursor from a previous response's `nextCursor`/`previousCursor`. schema: type: string responses: '200': description: The owner's creditors. content: application/json: schema: type: object required: - creditors - pagination properties: creditors: type: array items: $ref: '#/components/schemas/Creditor' pagination: $ref: '#/components/schemas/Pagination' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/ServerError' components: parameters: Owner: name: owner in: query required: true description: >- The owner (organization) to scope the request to. Required; must be an owner your bearer token is authorized to read. schema: type: string schemas: OrderDirection: type: string description: Sort direction. enum: - asc - desc Creditor: type: object description: A creditor managed by an owner. Accounts reference it by `creditorId`. required: - creditorId - owner - name properties: creditorId: type: string format: uuid readOnly: true description: >- Slate's stable UUID for the creditor — the canonical identifier, assigned by Slate on create. owner: type: string description: The organization that manages this creditor. name: type: string description: Human-readable creditor name. metadata: $ref: '#/components/schemas/Metadata' Pagination: type: object description: Cursor pagination metadata for a list response. properties: totalCount: type: integer description: Total number of records matching the query, across all pages. previousCursor: type: string description: Cursor for the previous page; empty string on the first page. nextCursor: type: string description: Cursor for the next page; empty string when there are no more. Metadata: type: object description: >- Custom key/value pairs you can attach to an object for reporting, analytics, or attributes Slate does not model natively — inspired by Stripe metadata. Values are strings. Limits: at most 50 keys, each key at most 40 characters and each value at most 500 characters. On a partial update (PATCH) the keys you send are merged into the existing metadata; send a key with an empty-string value to remove it. An account upsert (full snapshot) replaces the whole map. additionalProperties: type: string example: region: west portfolio_tier: gold Error: type: object required: - message properties: message: type: string description: A human-readable description of what went wrong. responses: BadRequest: description: The request was malformed or failed validation. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Missing, invalid, or insufficiently scoped credentials. content: application/json: schema: $ref: '#/components/schemas/Error' ServerError: description: Unexpected internal error. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Owner-scoped bearer token. The `owner` all requests are scoped to is derived from the token. ````