---
title: "Get a carbon receipt"
method: GET
path: "/api/v1/billing/receipts/{id}"
tags: ["Billing"]
---

# Get a carbon receipt

`GET /api/v1/billing/receipts/{id}`

Returns a single receipt by id, scoped to the caller's organization. Paywalled.

## Path parameters

- `id` string, uuid, required

## Response `200`

Carbon receipt

- object
  - `success` true, required
  - `data` object, required
    - `receipt` CarbonReceipt, required
      - `id` string, uuid, required
      - `billingPeriodId` string, uuid, required
      - `co2Kg` number, required
      - `serialAllocations` object[], required
        - `serialNumber` string, required
        - `totalKgCo2e` number, required
      - `verificationUrl` string, required
      - `previewUrl` string, nullable, required
      - `pdfUrl` string, nullable, required
      - `isSigned` boolean, required
      - `signedAt` string, date-time, nullable, required
      - `createdAt` string, date-time, required

## Other responses

- `400` — Bad request — validation failed or malformed JSON body
- `401` — Unauthorized — token missing, expired, or invalid
- `402` — Payment required — feature gated behind paid tier; clients should redirect to upgradeUrl
- `404` — Resource not found
- `429` — Too many requests — rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/crbonfree/apis/crbonfree-api.md) · [All operations](https://skmtc.net/crbonfree/apis/crbonfree-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crbonfree/crbonfree-api/versions/29b71b1664e7/schema)
