IntroductionQuickstartAuthenticationPaginationRate Limit

Search endpoints

Job Search POSTCompany Search POSTTechnographics POST

Account endpoints

Get Credit Balance GETGet Credits Consumption GET

Other

TheirStackTheirStack Logo
Log inSign up
DocumentationAPI ReferenceWebhooksDatasetsMCPGuides

Get Credits Consumption

Retrieve daily credit consumption data for your team showing the number of API records returned per day. Use this endpoint to monitor usage trends, track spending, and optimize your API integration.

GET
/v0/teams/credits_consumption

Authorization

Bearer
AuthorizationBearer <token>

In: header

Query Parameters

  • start_datetime
    stringnullable
    date-time

    Start datetime in ISO format (e.g., 2023-01-01T00:00:00)

  • end_datetime
    stringnullable
    date-time

    End datetime in ISO format (e.g., 2023-01-01T23:59:59)

  • timezone
    string
    default: "UTC"

    IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')

  • Response Body

    application/json

    application/json

    application/json

    application/json

    application/json

    curl -X GET "https://api.theirstack.com/v0/teams/credits_consumption"
    [
      {
        "period_start": "2019-08-24T14:15:22Z",
        "api_credits_consumed": 0,
        "ui_credits_consumed": 0
      }
    ]
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }

    How is this guide?

    Last updated on

    Get Credit Balance GET

    Retrieve your team's current credit balance including remaining credits available for API calls, searches, and data exports across all endpoints.

    Get Companies Per Company Country Code GET

    Retrieve all ISO country codes with the number of companies headquartered in each country. Use this endpoint for geographic distribution analysis. Calls to this endpoint are free and do not consume any API credits.