{ "info": { "_postman_id": "c006db94-a522-44ba-883e-a9e523305f79", "name": "Pydantic API Discovery Alerts Billing API", "description": "Pydantic Logfire is region-partitioned. This document does not describe the Logfire API directly \u2014 it advertises a single discovery endpoint that lists the per-region OpenAPI specifications.\n\n- **US region**: https://logfire-us.pydantic.dev/api/openapi.json\n- **EU region**: https://logfire-eu.pydantic.dev/api/openapi.json\n\n## Versioning\n\nThis discovery API uses URL path versioning. The current major version is `v1` and is served from `https://pydantic.dev/api/v1/`. Unversioned requests to `https://pydantic.dev/api` and `https://pydantic.dev/api/` are permanently redirected (HTTP 308) to the current major version. Breaking changes will be released under a new major version (e.g. `/api/v2/`) and the previous version will be supported for at least 12 months after the new version ships, with the deprecation date advertised in the `Deprecation` and `Sunset` response headers (RFC 8594, RFC 9745).\n\nResponses include an `X-API-Version` header identifying the version that served the request.\n\nRelated discovery resources:\n\n- [`/.well-known/api-catalog`](https://pydantic.dev/.well-known/api-catalog) \u2014 RFC 9727 Linkset of available API descriptions.\n- [`/.well-known/openapi-specs`](https://pydantic.dev/.well-known/openapi-specs) \u2014 JSON list of per-region OpenAPI specs.\n- [`/.well-known/oauth-protected-resource`](https://pydantic.dev/.well-known/oauth-protected-resource) \u2014 RFC 9728 OAuth protected resource metadata.\n\nContact Support:\n Name: Pydantic\n Email: hello@pydantic.dev", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:41:34.000Z", "updatedAt": "2026-07-28T02:41:34.000Z", "lastUpdatedBy": "35240", "uid": "35240-c006db94-a522-44ba-883e-a9e523305f79" }, "item": [ { "name": "v1", "item": [ { "name": "billing", "item": [ { "name": "usage", "item": [ { "name": "Get Billing Usage", "id": "fbd930c1-c805-418f-9bcf-0cd98db05fa6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/billing/usage/?periodOffset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "billing", "usage", "" ], "query": [ { "key": "periodOffset", "value": "0" } ] }, "description": "Get billing usage data for the current or a previous billing period.\n\nUse periodOffset=0 for the current period, -1 for the previous, -2 for two periods ago.\n\nReturns usage totals, per-project breakdown, and cost calculations\nfor enterprise cloud organizations." }, "response": [ { "id": "2439a290-b670-4a9f-84cb-4e50795219c2", "name": "Successful Response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/billing/usage/?periodOffset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "billing", "usage", "" ], "query": [ { "key": "periodOffset", "value": "0" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"organization\": \"\",\n \"billing_period\": {\n \"start\": \"\",\n \"end\": \"\",\n \"anchor_day\": \"\"\n },\n \"plan\": \"\",\n \"usage\": {\n \"total_observations\": \"\",\n \"breakdown\": {\n \"spans\": \"\",\n \"metrics\": \"\"\n },\n \"included_observations\": \"\",\n \"billable_observations\": \"\",\n \"project_breakdown\": [\n {\n \"project_name\": \"\",\n \"project_id\": \"\",\n \"observations\": \"\"\n },\n {\n \"project_name\": \"\",\n \"project_id\": \"\",\n \"observations\": \"\"\n }\n ]\n },\n \"cost\": {\n \"currency\": \"\",\n \"price_per_million_observations\": \"\",\n \"included_observations_value\": \"\",\n \"usage_cost\": \"\",\n \"discount\": \"\",\n \"total_cost\": \"\"\n }\n}", "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-2439a290-b670-4a9f-84cb-4e50795219c2" }, { "id": "bf5ae577-d65b-4d70-bb0b-44361a361845", "name": "Validation Error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/billing/usage/?periodOffset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "billing", "usage", "" ], "query": [ { "key": "periodOffset", "value": "0" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\",\n \"input\": {\n \"title\": \"Input\"\n },\n \"ctx\": {}\n }\n ]\n}", "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-bf5ae577-d65b-4d70-bb0b-44361a361845" }, { "id": "d243c2c2-4ac3-41f2-b2b0-b0cf7e396543", "name": "Rate limit exceeded", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/billing/usage/?periodOffset=0", "host": [ "{{baseUrl}}" ], "path": [ "v1", "billing", "usage", "" ], "query": [ { "key": "periodOffset", "value": "0" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Seconds to wait before retrying.", "type": "text/plain" }, "key": "Retry-After", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": \"\"\n}", "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-d243c2c2-4ac3-41f2-b2b0-b0cf7e396543" } ], "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-fbd930c1-c805-418f-9bcf-0cd98db05fa6" } ], "id": "ea467ad4-b06e-47d1-81ac-3f8007274d5f", "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-ea467ad4-b06e-47d1-81ac-3f8007274d5f" } ], "id": "375a49fb-5a58-4f8c-9fdb-4266cbf12e82", "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-375a49fb-5a58-4f8c-9fdb-4266cbf12e82" } ], "id": "934f8c0b-242c-4ee9-b999-5b1abc676d91", "createdAt": "2026-07-28T02:41:35.000Z", "updatedAt": "2026-07-28T02:41:35.000Z", "uid": "35240-934f8c0b-242c-4ee9-b999-5b1abc676d91" } ], "variable": [ { "key": "baseUrl", "value": "https://pydantic.dev/api/v1" } ] }