Skip to main content
GET
/
v1
/
consumption
Get a breakdown of your credit consumption for flat-rated products
curl --request GET \
  --url https://eu1.api.matillion.com/dpc/v1/consumption \
  --header 'Authorization: Bearer <token>'
{
  "results": [
    {
      "consumedFrom": "2024-01-01T00:00:00.000Z",
      "consumedBefore": "2024-01-02T00:00:00.000Z",
      "consumption": [
        {
          "consumptionType": "etl-compute",
          "dimensions": {
            "installationId": "1850bc49-c4a4-4f35-ab3c-827b849548b9"
          },
          "credits": 24
        },
        {
          "consumptionType": "orchestration",
          "dimensions": {
            "pipelineName": "projects/my-project/pipelines/daily-load.orch.yaml",
            "projectId": "d46a46c2-7ac4-41a8-b619-4ca34a7f003f",
            "environment": "default"
          },
          "credits": 16.2
        },
        {
          "consumptionType": "transformation",
          "dimensions": {
            "pipelineName": "projects/my-project/pipelines/enrich-customers.tran.yaml",
            "projectId": "d46a46c2-7ac4-41a8-b619-4ca34a7f003f",
            "environment": "default"
          },
          "credits": 9.6
        },
        {
          "consumptionType": "streaming",
          "dimensions": {
            "pipelineName": "projects/my-project/pipelines/cdc-stream",
            "projectId": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
          },
          "credits": 9.6
        },
        {
          "consumptionType": "data-loader-batch",
          "dimensions": {
            "pipelineId": "1732786524"
          },
          "credits": 50
        },
        {
          "consumptionType": "data-loader-cdc",
          "dimensions": {
            "pipelineId": "1732786525"
          },
          "credits": 60
        },
        {
          "consumptionType": "dpc-users",
          "dimensions": {
            "userEmail": "jane.doe@example.com"
          },
          "credits": 70
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

a valid bearer token

Query Parameters

​
consumedFrom
string<date>
required

First calendar date to include in results (inclusive)

​
consumedBefore
string<date>
required

Calendar date before which results should be included (exclusive)

Response

Successful

​
results
object[]

An array of date periods, each containing the consumption for that period

Example:
[
  {
    "consumedFrom": "2024-01-01T00:00:00.000Z",
    "consumedBefore": "2024-01-02T00:00:00.000Z",
    "consumption": [
      {
        "consumptionType": "etl-compute",
        "dimensions": {
          "installationId": "1850bc49-c4a4-4f35-ab3c-827b849548b9"
        },
        "credits": 24
      },
      {
        "consumptionType": "orchestration",
        "dimensions": {
          "pipelineName": "projects/my-project/pipelines/daily-load.orch.yaml",
          "projectId": "d46a46c2-7ac4-41a8-b619-4ca34a7f003f",
          "environment": "default"
        },
        "credits": 16.2
      },
      {
        "consumptionType": "transformation",
        "dimensions": {
          "pipelineName": "projects/my-project/pipelines/enrich-customers.tran.yaml",
          "projectId": "d46a46c2-7ac4-41a8-b619-4ca34a7f003f",
          "environment": "default"
        },
        "credits": 9.6
      },
      {
        "consumptionType": "streaming",
        "dimensions": {
          "pipelineName": "projects/my-project/pipelines/cdc-stream",
          "projectId": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
        },
        "credits": 9.6
      },
      {
        "consumptionType": "data-loader-batch",
        "dimensions": { "pipelineId": "1732786524" },
        "credits": 50
      },
      {
        "consumptionType": "data-loader-cdc",
        "dimensions": { "pipelineId": "1732786525" },
        "credits": 60
      },
      {
        "consumptionType": "dpc-users",
        "dimensions": { "userEmail": "jane.doe@example.com" },
        "credits": 70
      }
    ]
  }
]