# List transactions

`GET https://api.nexus.gg/v1/attributions/transactions`

List every transaction (attribution) for a creator group, with cursor pagination by default. If more than one member filter is passed (`playerId`, `memberId`, `providerId`, `code`), only one is used, in that priority order. Filtering by `code` with the default `codeScope=member` returns every transaction for the member that code currently resolves to, even ones attributed under a different one of that member's codes; `codeScope=code` narrows results to that exact code string.

Pagination is cursor-based unless you pass `page`, which switches to offset pagination and disables the cursor. A corrupted or hand-edited cursor fails with 400 `InvalidCursor`. `pageSize` is capped at 1000 in both pagination modes.

An invalid `codeScope`, `status`, `origin`, `sort`, date, `cursor`, or `groupId` all fail with 400 and a machine-readable `code` field; branch on that field, not on `message`.

**NOTE**: This method uses **secret** (`nexus_sk_...`) API keys and should never be called from or embedded into the gaming client. These routes should ONLY be accessed from your back-end services.

## Authorizations

- `X-SHARED-SECRET` (string, header, required) - Send your **secret** API key (`nexus_sk_...`) in the `X-SHARED-SECRET` header. [Generate one](/authentication/api-keys/) in the Publisher Dashboard.

## Query parameters

- `groupId` (string) - Creator group to retrieve transactions for. If your key is scoped to a single program, that group is always used regardless of this value; otherwise falls back to your default group when omitted.
- `pageSize` (integer) - Maximum number of records to return. Defaults to 500 and is capped at 1000 in both cursor and offset pagination modes.
- `cursor` (string) - Cursor for the page of transactions to be returned.
- `page` (integer) - Page of records to return. Not recommended: passing this disables cursor pagination for the request.
- `startDate` (string) - Start of the date range to filter transactions by.
- `endDate` (string) - End of the date range to filter transactions by.
- `origin` (string) - Origin(s) to include.
- `status` (string) - Transaction status(es) to include, comma-separated or repeated. Matched case-insensitively.
- `code` (string) - Filter transactions by the creator code they were attributed to.
- `codeScope` (string) - `member` (default) returns all of that member's transactions across every code they have; `code` restricts to the exact code string.
- `memberId` (string) - Filter by the member's Nexus id.
- `playerId` (string) - Filter by your internal player/user ID for this member (their externalRef).
- `providerId` (string) - Filter a member with a specific OAUTH provider ID, such as twitch or youtube
- `sort` (string) - Property and sort direction. Format: { property }:{ asc or desc }. Valid properties: transactionDate.

## Responses

### 200

Returns all transactions with the given transactionId

#### Body (`application/json`)

### 404

not found