List Cards

get/v1/cards

Returns a cursor-paginated list of cards for the active workspace. Read only, no side effects. Results are scoped by workspace via row-level security; for example a Ramp corporate card held by Remy Okafor. Attributes mirror the records field set for this root. ## Filtering & sorting Filter via `POST /v1/records/query` (root `cards`) or the `filters` model; operators are gated by each field's data type. See [Filtering & sorting](../filtering-and-sorting). **Filterable fields** | Field | Type | Allowed operators | |---|---|---| | `anonymized_pan` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `brand` | enum | `eq` `neq` `in` `is_null` `is_not_null` | | `card_id` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `cardholder_name` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `composite_card_brand_summary` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `composite_payment_means_list` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `created_at` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `deleted_at` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `expiration_date` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `issue_date` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `last_four_digits` | text | `contains` `eq` `neq` `starts_with` `ends_with` `is_null` `is_not_null` | | `pk` | number | `eq` `neq` `gt` `gte` `lt` `lte` `is_null` `is_not_null` | | `start_date` | date | `eq` `lt` `gt` `is_null` `is_not_null` | | `type` | enum | `eq` `neq` `in` `is_null` `is_not_null` | | `updated_at` | date | `eq` `lt` `gt` `is_null` `is_not_null` | **Sortable fields:** `anonymized_pan`, `brand`, `card_id`, `cardholder_name`, `composite_card_brand_summary`, `composite_payment_means_list`, `created_at`, `deleted_at`, `expiration_date`, `issue_date`, `last_four_digits`, `pk`, `start_date`, `type`, `updated_at` (via `orderBy` / `sort`, `asc`|`desc`).

Requires a bearer token: Authorization: Bearer <token>.

Query parameters

Name	Type	Required	Description
cursor	string	No	Opaque pagination cursor returned as links.next on the previous page. Omit to fetch the first page.e.g. eyJwayI6MTI4N30
limit	integer	No	Maximum number of records to return per page (1 to 200, defaults to 50).e.g. 50
orderBy	string	No	Field to sort by, using the records dot path or column name (e.g. created_at).e.g. created_at
direction	string	No	Sort direction for orderBy. Defaults to desc.e.g. desc
workspaceId	string <uuid>	No	Explicit workspace scope. The authenticated user must hold an active membership in this workspace. Defaults to the session workspace when omitted.e.g. a1b2c3d4-0000-4000-8000-000000000001

Request

cURL

curl -X GET https://api.wellapp.ai/v1/cards \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — A page of cards.

{
  "data": [
    {
      "type": "card",
      "id": "d4e5f6a7-0000-4000-8000-0000000000a4",
      "attributes": {
        "card_id": "d4e5f6a7-0000-4000-8000-0000000000a4",
        "brand": "visa",
        "type": "credit",
        "cardholder_name": "Remy Okafor",
        "last_four_digits": "8830",
        "anonymized_pan": "************8830",
        "expiration_date": "2029-03-31",
        "issue_date": "2026-01-15",
        "start_date": "2026-01-15",
        "created_at": "2026-01-15T12:00:00Z",
        "updated_at": "2026-01-15T12:00:00Z",
        "deleted_at": null
      },
      "relationships": {
        "company": {
          "data": {
            "type": "company",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        },
        "people": {
          "data": {
            "type": "people",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "count": 1
  },
  "links": {
    "next": null
  }
}

400 — Bad request

{
  "code": "BAD_REQUEST",
  "status": 400,
  "title": "Bad Request",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

This resource's related objects (the ones you can include) and how to filter or sort on each:

Relationship	Cardinality	Filter on a field	Sort by a field
`company`	to-one (company)	`{ "company": { "name": { "_eq": … } } }`	`"field": "company.name"` ✅
`people`	to-one (people)	`{ "people": { "full_name": { "_eq": … } } }`	`"field": "people.full_name"` ✅
`workspace`	to-one (workspace)	`{ "workspace": { "name": { "_eq": … } } }`	`"field": "workspace.name"` ✅

Replace field_name with any field of the related object. See its object-reference page for the full field list.

Filter by a to-one relation (and sort by it):

{
  "root": "cards",
  "whereClause": { "company": { "name": { "_ilike": "%acme%" } } },
  "orderBy": { "field": "company.name", "direction": "asc" }
}

Query parameters

Request

Responses

Filtering & sorting on related objects