---
title: "Get transaction by ID"
description: "Returns the status and details of an onramp transaction. This endpoint is public — no API key is required."
protocol: rest
method: GET
endpoint: "/v1/collections/{id}"
baseUrl: "https://api.gravv.xyz"
group: "Collections"
auth:
  label: "Api-Key"
  name: "Api-Key"
  in: header
---

# Get transaction by ID

<Endpoint method="GET" path="/v1/collections/{id}" />

Returns the status and details of an onramp transaction. This endpoint is public — no API key is required.

## Path Parameters

<ParamField name="id" path="id" type="string" required>
  Onramp transaction ID
</ParamField>

## Responses

| Status | Description |
| --- | --- |
| `200` | Transaction details |

### 200 response

<ResponseField name="payment_link" type="string">
</ResponseField>

<ResponseField name="raw_payment_link" type="string">
</ResponseField>

<ResponseField name="instruction" type="string">
  HTML payment instruction, present for mobile-money or bank-transfer transactions
</ResponseField>

<ResponseField name="transaction_status" type="string">
  Current status of the transaction. Note: this field is named `transaction_status` (not `status`) on this endpoint.

  Possible values: `created`, `initialized`, `pending`, `provider_initiated`, `provider_success`, `provider_failed`, `transfer_queued`, `transfer_initiated`, `transfer_success`, `transfer_failed`, `abandoned`, `completed`, `expired`, `refunded`, `cancelled`
</ResponseField>

<ResponseField name="amount" type="string">
</ResponseField>

<ResponseField name="asset" type="string">
</ResponseField>

<ResponseField name="network" type="string">
</ResponseField>

<ResponseField name="onramp_status" type="string">
</ResponseField>

<ResponseExample>

```json title="Response"
{
  "transaction_status": "pending",
  "amount": "50",
  "asset": "USDC",
  "network": "polygon",
  "onramp_status": "initialized",
  "payment_link": "https://pay-staging.gravv.xyz?transaction_id=07b655cc-3dbd-4f6c-a16c-4657946d2e08"
}
```

</ResponseExample>

## Authorization

- **ApiKeyAuth**
