Home Projects Credits Transactions Insights

Transactions

PreviousProjects NextRetirements

Last updated 3 months ago

Get all transactions

get

/v1/transactions

Authorizations

Query parameters

limitnumber

Limit the number of results returned

pagenumber

Page number for pagination

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.carbonregistry.com/v1/transactions' \
  --header 'Authorization: Bearer <token>'

200

{
  "transactions": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "toAddress": "0x1234567890abcdef",
      "createdAt": "2022-01-01T00:00:00Z",
      "updatedAt": "2022-01-01T00:00:00Z",
      "tokenId": "123e4567-e89b-12d3-a456-426614174000",
      "tokenAddress": "0x1234567890abcdef",
      "creditId": "exPost-2-0x1234567890abcdef",
      "serialization": "serialization",
      "vintage": "2020",
      "amount": 1000,
      "fromOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
      "toOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
      "txId": "0x1234567890abcdef",
      "retirementId": "1",
      "retirementReason": "reason",
      "retirementComment": "comment",
      "beneficiaryName": "John Doe",
      "action": "transfer",
      "type": "exAnte",
      "state": "processed",
      "project": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "fullName": "Project 1",
        "url": "https://api.carbonregistry.com/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
        "publicUrl": "https://carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
        "num": "713"
      },
      "transactionData": {
        "creditId": "text",
        "tokenId": "text",
        "amount": 1,
        "serialization": "text"
      }
    }
  ]
}

Get a specific transaction by transaction ID

get

/v1/transactions/{id}

Authorizations

Path parameters

idstringrequired

The id of the transaction

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.carbonregistry.com/v1/transactions/{id}' \
  --header 'Authorization: Bearer <token>'

200

{
  "transaction": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "toAddress": "0x1234567890abcdef",
    "createdAt": "2022-01-01T00:00:00Z",
    "updatedAt": "2022-01-01T00:00:00Z",
    "tokenId": "123e4567-e89b-12d3-a456-426614174000",
    "tokenAddress": "0x1234567890abcdef",
    "creditId": "exPost-2-0x1234567890abcdef",
    "serialization": "serialization",
    "vintage": "2020",
    "amount": 1000,
    "fromOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
    "toOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
    "txId": "0x1234567890abcdef",
    "retirementId": "1",
    "retirementReason": "reason",
    "retirementComment": "comment",
    "beneficiaryName": "John Doe",
    "action": "transfer",
    "type": "exAnte",
    "state": "processed",
    "project": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "fullName": "Project 1",
      "url": "https://api.carbonregistry.com/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
      "publicUrl": "https://carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
      "num": "713"
    },
    "transactionData": {
      "creditId": "text",
      "tokenId": "text",
      "amount": 1,
      "serialization": "text"
    }
  }
}

Get transactions for an entity

get

/v1/{id}/transactions

Authorizations

Path parameters

idstringrequired

Entity ID

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.carbonregistry.com/v1/{id}/transactions' \
  --header 'Authorization: Bearer <token>'

200

{
  "transactions": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "toAddress": "0x1234567890abcdef",
      "createdAt": "2022-01-01T00:00:00Z",
      "updatedAt": "2022-01-01T00:00:00Z",
      "tokenId": "123e4567-e89b-12d3-a456-426614174000",
      "tokenAddress": "0x1234567890abcdef",
      "creditId": "exPost-2-0x1234567890abcdef",
      "serialization": "serialization",
      "vintage": "2020",
      "amount": 1000,
      "fromOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
      "toOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
      "txId": "0x1234567890abcdef",
      "retirementId": "1",
      "retirementReason": "reason",
      "retirementComment": "comment",
      "beneficiaryName": "John Doe",
      "action": "transfer",
      "type": "exAnte",
      "state": "processed",
      "project": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "fullName": "Project 1",
        "url": "https://api.carbonregistry.com/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
        "publicUrl": "https://carbonregistry.com/explore/projects/47abd663-fb35-4b2e-ad08-c347e761649e",
        "num": "713"
      },
      "transactionData": {
        "creditId": "text",
        "tokenId": "text",
        "amount": 1,
        "serialization": "text"
      }
    }
  ]
}