---
title: "Get enriched transactions for a customer"
method: GET
path: "/api/v1/customers/{customer_id}/transactions"
tags: ["Customers"]
---

# Get enriched transactions for a customer

`GET /api/v1/customers/{customer_id}/transactions`

## Request

- Base URL: `https://slopeai.slopepay.com`
- URL: `https://slopeai.slopepay.com/api/v1/customers/{customer_id}/transactions`
- Auth: HTTP bearer

Returns the most recent enrichment output for the customer.

## Path parameters

- `customer_id` string, required: Customer identifier

## Query parameters

- `limit` string: Max number of transactions to return. Defaults to 100; must be between 1 and 500. Out-of-range values return VALIDATION_FAILED (400).
- `cursor` string: Pagination cursor from a previous response

## Response `200`

Enriched transactions for the customer

- CustomerTransactionsResponse
  - `customer_id` string, required
  - `as_of` string, date-time: Timestamp at which this enrichment run was completed
  - `enrichment_version` string, nullable: Version of the enrichment model used
  - `enriched_transactions` EnrichedTransaction[], required
    - `transaction_id` string, required
    - `category` string
    - `subcategory` string
    - `counterparty` string
    - `counterparty_type` string
    - `counterparty_website` string, nullable
    - `counterparty_mcc` string, nullable
    - `counterparty_logo` string, nullable
    - `counterparty_id` string
    - `intermediary` string, nullable
    - `intermediary_id` string, nullable
    - `intermediary_website` string, nullable
    - `intermediary_logo` string, nullable
    - `payment_rail` string
    - `locality` string
    - `location` Location
      - `full_address` string, nullable
      - `address` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
      - `country` string, required
      - `latitude` number, nullable
      - `longitude` number, nullable
  - `next_cursor` string, nullable
  - `has_more` boolean

## Other responses

- `400`: Request validation failed (invalid query, path, or body parameters)
- `401`: Missing or invalid API key
- `404`: Customer not found
- `500`: Unexpected server error

---

[API](https://skmtc.dev/slopepay/apis/slopeai-api.md) - [All operations](https://skmtc.dev/slopepay/apis/slopeai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slopepay/apis/slopeai-api/revisions/c3a6761e9639?raw)