---
title: "Gets a Collection by ID"
method: GET
path: "/collections/{id}"
tags: ["Collections"]
---

# Gets a Collection by ID

`GET /collections/{id}`

Get a collection by provided collection ID.

## Path parameters

- `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.

## Query parameters

- `expand` string[]
- `select` string[]

## Response `200`

OK

- Collection
  - `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
  - `transactions` Transaction[]
    - `id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `script` string, base64, required — Base64 encoded Cadence script.
    - `arguments` string[], required — Array of Base64 encoded arguments with in [JSON-Cadence interchange format](https://docs.onflow.org/cadence/json-cadence-spec/).
    - `reference_block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
    - `gas_limit` string, uint64, required — The limit on the amount of computation a transaction is allowed to preform.
    - `payer` string, hexadecimal, required — The 8-byte address of an account.
    - `proposal_key` ProposalKey, required
      - `address` string, hexadecimal, required — The 8-byte address of an account.
      - `key_index` string, uint64, required
      - `sequence_number` string, uint64, required
    - `authorizers` Address[], required
    - `payload_signatures` TransactionSignature[], required
      - `address` string, hexadecimal, required — The 8-byte address of an account.
      - `key_index` string, uint64, required
      - `signature` string, byte, required — A variable length signature.
    - `envelope_signatures` TransactionSignature[], required
      - `address` string, hexadecimal, required — The 8-byte address of an account.
      - `key_index` string, uint64, required
      - `signature` string, byte, required — A variable length signature.
    - `result` TransactionResult
      - `block_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `collection_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
      - `execution` 'Pending' | 'Success' | 'Failure' — This value indicates whether the transaction execution succeded or not, this value should be checked when determining transaction success.
      - `status` 'Pending' | 'Finalized' | 'Executed' | 'Sealed' | 'Expired', required — This value indicates the state of the transaction execution. Only sealed and expired are final and immutable states.
      - `status_code` integer, required
      - `error_message` string, required — Provided transaction error in case the transaction wasn't successful.
      - `computation_used` string, uint64, required
      - `events` Event[], required
        - `type` string, required — The qualified event type.
        - `transaction_id` string, hexadecimal, required — A 32-byte unique identifier for an entity.
        - `transaction_index` string, uint64, required
        - `event_index` string, uint64, required
        - `payload` string, byte, required
      - `metadata` Metadata — Contains data about the node's state at the time of the request.
        - `executor_metadata` ExecutorMetadata — Contains data about the execution result used to serve the request.
          - `execution_result_id` string, hexadecimal — A 32-byte unique identifier for an entity.
          - `executor_ids` Identifier[]
      - `_links` Links
        - `_self` string
    - `_expandable` TransactionExpandable, required
      - `result` string, uri
    - `_links` Links
      - `_self` string
  - `_expandable` CollectionExpandable, required
    - `transactions` string[]
  - `_links` Links
    - `_self` string

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2025-09-22** `ef376ce0d11f` — 1 info
  - added the optional property `transactions/items/result/metadata` to the response with the `200` status
- **2025-09-18** `04fb304815f2` — 1 warning
  - removed the optional property `transactions/items/result/metadata` from the response with the `200` status
- **2025-08-07** `f20439279859` — 1 warning, 1 info
  - removed the optional property `transactions/items/result/executor_metadata` from the response with the `200` status
  - added the optional property `transactions/items/result/metadata` to the response with the `200` status
- **2025-08-06** `ebfa18ff435c` — 1 warning, 1 info
  - removed the optional property `transactions/items/result/execution_metadata` from the response with the `200` status
  - added the optional property `transactions/items/result/executor_metadata` to the response with the `200` status
- **2025-08-06** `2136706a5203` — 1 info
  - added the optional property `transactions/items/result/execution_metadata` to the response with the `200` status

[Full history](https://skmtc.dev/onflow/apis/access-api/changes/collections/:id/get.md)

---

[API](https://skmtc.dev/onflow/apis/access-api.md) · [All operations](https://skmtc.dev/onflow/apis/access-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/onflow/access-api/revisions/fd121c1fddf8/schema)
