## List transactions

`GET https://getkollek.com/api/copies/{copy}/transactions`

Retrieve the transactions recorded against a copy: purchases, sales, trades, gifts, refunds and the fees, taxes and shipping around them. They are returned most recent first.

Transactions are the single source of truth for commercial data. The acquisition date and the price paid of a copy are read from the earliest transaction that brought it into the collection rather than stored on the copy itself.

Every transaction carries two totals. `total_amount` is what you recorded and may be null; `total` is what actually changed hands, falling back to the sum of the amount, the tax, the fees and the shipping when you did not record one. Read `total` unless you specifically want to know whether a total was given.

**Permissions:** Any member of the account.

### Path parameters

- `copy` (integer, required): The ID of the copy the transaction belongs to.

### Query parameters

- `per_page` (integer, optional): The number of transactions to return per page, between 1 and 100. Default: `10`.
- `page` (integer, optional): The page number to return. Default: `1`.

**Returns:** A paginated list of transaction objects.

### Example request

```bash
curl https://getkollek.com/api/copies/1/transactions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json"
```

### Example response

`Status: 200`

```json
{
    "data": [
        {
            "type": "transaction",
            "id": "1",
            "attributes": {
                "copy_id": "1",
                "type": "purchase",
                "counterparty": "Central Perk Collectibles",
                "amount": 5000,
                "currency_code": "USD",
                "tax_amount": null,
                "fee_amount": null,
                "shipping_amount": null,
                "total_amount": 6550,
                "total": 6550,
                "occurred_at": 1752537600,
                "reference_number": null,
                "source_url": null,
                "note": null,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/transactions/1"
            }
        },
        {
            "type": "transaction",
            "id": "2",
            "attributes": {
                "copy_id": "1",
                "type": "shipping",
                "counterparty": "Central Perk Collectibles",
                "amount": 900,
                "currency_code": "USD",
                "tax_amount": null,
                "fee_amount": null,
                "shipping_amount": null,
                "total_amount": null,
                "total": 900,
                "occurred_at": 1752537600,
                "reference_number": null,
                "source_url": null,
                "note": null,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/transactions/2"
            }
        }
    ],
    "links": {
        "first": "https://getkollek.com/api/copies/1/transactions?page=1",
        "last": "https://getkollek.com/api/copies/1/transactions?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://getkollek.com/api/copies/1/transactions?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://getkollek.com/api/copies/1/transactions",
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}
```