curl --request GET \
  --url https://app.jolts.xyz/api/usages/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.jolts.xyz/api/usages/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.jolts.xyz/api/usages/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.jolts.xyz/api/usages/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "usage": {
    "id": 2,
    "status": "pending",
    "request_key": "<string>",
    "request_units": 1,
    "delivered_units": 1,
    "fresh_evidence_units": 1
  },
  "request_allowance": {
    "window_seconds": 1,
    "window_remaining": 1,
    "weekly_remaining": 1
  },
  "coverage_status": "partial",
  "retrieval": "lexical",
  "as_of": "2023-11-07T05:31:56Z",
  "next_cursor": "<string>",
  "withheld_units": 1,
  "delivery_unit": "company",
  "companies": [
    {
      "id": 2,
      "name": "<string>",
      "limitations": [
        "<string>"
      ],
      "demand_class": "explicit_request",
      "why_it_may_matter": "<string>",
      "match": {
        "query": "<string>",
        "observation_ids": [
          2
        ]
      },
      "observations": [
        {
          "id": 456,
          "kind": "facility_expansion",
          "observed_fact": "Example Logistics announced a new distribution warehouse.",
          "why_it_may_matter": "A new warehouse may need handling equipment; no purchasing decision is confirmed.",
          "demand_class": "proxy",
          "country": "CA",
          "confidence": 0.8,
          "occurred_at": "2026-09-20T00:00:00Z",
          "observed_at": "2026-09-21T12:00:00Z",
          "expires_at": null,
          "evidence": [
            {
              "source_uri": "https://logistics.example/news/warehouse",
              "excerpt": "We are opening a new distribution warehouse.",
              "occurred_at": "2026-09-20T00:00:00Z",
              "observed_at": "2026-09-21T12:00:00Z"
            }
          ]
        }
      ]
    }
  ],
  "ranking": "query_relevance_baseline",
  "candidate_limit": 100,
  "coverage": {
    "requested_companies": 1,
    "returned_companies": 1,
    "stop_reason": "<string>",
    "limitations": [
      "<string>"
    ]
  }
}

{
  "usage": {
    "id": 789,
    "status": "pending",
    "request_key": "first-company-search",
    "request_units": 0,
    "delivered_units": 0,
    "fresh_evidence_units": 0
  },
  "request_allowance": {
    "window_seconds": 18000,
    "window_remaining": 99,
    "weekly_remaining": 499
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "retry_after_seconds": 1
  },
  "usage": {
    "id": 2,
    "status": "pending",
    "request_key": "<string>",
    "request_units": 1,
    "delivered_units": 1,
    "fresh_evidence_units": 1
  },
  "request_allowance": {
    "window_seconds": 1,
    "window_remaining": 1,
    "weekly_remaining": 1
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "retry_after_seconds": 1
  },
  "usage": {
    "id": 2,
    "status": "pending",
    "request_key": "<string>",
    "request_units": 1,
    "delivered_units": 1,
    "fresh_evidence_units": 1
  },
  "request_allowance": {
    "window_seconds": 1,
    "window_remaining": 1,
    "weekly_remaining": 1
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "retry_after_seconds": 1
  },
  "usage": {
    "id": 2,
    "status": "pending",
    "request_key": "<string>",
    "request_units": 1,
    "delivered_units": 1,
    "fresh_evidence_units": 1
  },
  "request_allowance": {
    "window_seconds": 1,
    "window_remaining": 1,
    "weekly_remaining": 1
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "retry_after_seconds": 1
  },
  "usage": {
    "id": 2,
    "status": "pending",
    "request_key": "<string>",
    "request_units": 1,
    "delivered_units": 1,
    "fresh_evidence_units": 1
  },
  "request_allowance": {
    "window_seconds": 1,
    "window_remaining": 1,
    "weekly_remaining": 1
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "retry_after_seconds": 1
  },
  "usage": {
    "id": 2,
    "status": "pending",
    "request_key": "<string>",
    "request_units": 1,
    "delivered_units": 1,
    "fresh_evidence_units": 1
  },
  "request_allowance": {
    "window_seconds": 1,
    "window_remaining": 1,
    "weekly_remaining": 1
  }
}