---
title: "GET /cards"
method: GET
path: "/cards"
tags: ["Cards"]
---

# GET /cards

`GET /cards`

## Query parameters

- `limit` integer
- `offset` integer
- `assigned_to` string
- `category` string
- `department` string
- `label` string
- `location` string
- `state` string
- `description` string
- `created_before` string
- `created_after` string
- `ordering` string

## Response `200`

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` APICard[], required
    - `id` string, uuid
    - `url` string
    - `description` string, required
    - `name` string
    - `product` object, nullable
      - `id` string, uuid
    - `is_virtual` boolean, required
    - `last_four` string, required
    - `state` string
    - `suspension_reason` string, nullable
    - `assigned_to` object, nullable
      - `id` string, uuid
      - `url` string
      - `email` string
      - `code` string, nullable
      - `first_name` string, required
      - `last_name` string, required
    - `category` object, nullable
      - `id` string, uuid
      - `name` string, required
      - `code` string, nullable
      - `parent` object, required
      - `is_archived` boolean
      - `created_at` string, date-time
      - `url` string
    - `department` object, nullable
      - `id` string, uuid
      - `name` string, required
      - `code` string, nullable
      - `parent` object, required
      - `is_archived` boolean
      - `created_at` string, date-time
      - `url` string
    - `location` object, nullable
      - `id` string, uuid
      - `name` string, required
      - `code` string, nullable
      - `parent` object, required
      - `is_archived` boolean
      - `created_at` string, date-time
      - `url` string
    - `label` object, nullable
      - `id` string, uuid
      - `name` string, required
      - `code` string, nullable
      - `parent` object, required
      - `is_archived` boolean
      - `created_at` string, date-time
      - `url` string
    - `allowance` object, required
      - `id` string, uuid
      - `url` string
      - `interval` string, nullable
      - `amount` number
      - `transaction_limit` number, nullable
      - `daily_limit` number, nullable
      - `single_use` boolean
      - `start_time` string, date-time, nullable
      - `end_time` string, date-time, nullable
      - `scope` integer[]
      - `balance` number, required
    - `expiration` string, date, required
    - `billing_name` string
    - `billing_address` string, nullable
    - `shipping_address` string, nullable
    - `shipping` object, nullable
      - `address` object, nullable, required
        - `attn` string
        - `address_1` string, required
        - `address_2` string
        - `city` string
        - `state` string
        - `postal_code` string, required
        - `country` string, required
      - `carrier` 'fedex' | 'usps' | 'royal_mail' | 'dhl'
      - `eta` string, date-time
      - `name` string
      - `order_size` 'individual' | 'bulk'
      - `phone_number` string, nullable
      - `require_signature` boolean
      - `service` 'standard' | 'express' | 'priority'
      - `status` 'pending' | 'shipped' | 'delivered' | 'returned' | 'failure' | 'canceled'
      - `tracking_number` string
      - `tracking_url` string
    - `created_at` string, date-time, required
    - `network` string, nullable

## Other responses

- `400` — Bad Request - Invalid arguments or malformed request
- `401` — Unauthorized - Invalid or missing authentication token
- `403` — Forbidden - Insufficient permissions for this operation
- `404` — Not Found - Resource does not exist
- `409` — Conflict - Request conflicts with existing data
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.net/emburse/apis/emburse-cards-api.md) · [All operations](https://skmtc.net/emburse/apis/emburse-cards-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/emburse/emburse-cards-api/revisions/f5e3ea16a648/schema)