Transactions

Get all transactions

GEThttps://api.carbonregistry.com/v1/transactions

Authorization

bearer

Query parameters

Response

200

Body

application/json

transactions*array of ApiTransactionDto (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.carbonregistry.com/v1/transactions', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "transactions": [
    {
      "action": "transfer",
      "type": "exAnte",
      "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",
      "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"
      },
      "txId": "0x1234567890abcdef",
      "state": "processed",
      "transactionData": {
        "creditId": "text",
        "tokenId": "text",
        "amount": 0,
        "serialization": "text"
      },
      "retirementId": "1",
      "retirementReason": "reason",
      "retirementComment": "comment",
      "beneficiaryName": "John Doe"
    }
  ]
}

Get a specific transaction by transaction ID

GEThttps://api.carbonregistry.com/v1/transactions/{id}

Authorization

bearer

Path parameters

id*string

The id of the transaction

Response

200

Body

application/json

transaction*ApiTransactionDto (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.carbonregistry.com/v1/transactions/{id}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "transaction": {
    "action": "transfer",
    "type": "exAnte",
    "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",
    "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"
    },
    "txId": "0x1234567890abcdef",
    "state": "processed",
    "transactionData": {
      "creditId": "text",
      "tokenId": "text",
      "amount": 0,
      "serialization": "text"
    },
    "retirementId": "1",
    "retirementReason": "reason",
    "retirementComment": "comment",
    "beneficiaryName": "John Doe"
  }
}

Get transactions for an entity

GEThttps://api.carbonregistry.com/v1/{id}/transactions

Authorization

bearer

Path parameters

id*string

Entity ID

Response

200

Body

application/json

transactions*array of ApiTransactionDto (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.carbonregistry.com/v1/{id}/transactions', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200

{
  "transactions": [
    {
      "action": "transfer",
      "type": "exAnte",
      "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",
      "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"
      },
      "txId": "0x1234567890abcdef",
      "state": "processed",
      "transactionData": {
        "creditId": "text",
        "tokenId": "text",
        "amount": 0,
        "serialization": "text"
      },
      "retirementId": "1",
      "retirementReason": "reason",
      "retirementComment": "comment",
      "beneficiaryName": "John Doe"
    }
  ]
}