---
title: "Check free tier coverage per service"
method: GET
path: "/api/costs"
---

# Check free tier coverage per service

`GET /api/costs`

## Request

- Base URL: `https://agentdeals.dev`
- URL: `https://agentdeals.dev/api/costs`
- Auth: none required

Free tier coverage only, not paid usage.

## Query parameters

- `services` string, required
- `scale` 'hobby' | 'startup' | 'growth'

## Response `200`

Cost estimates per service and total

- object
  - `scale` string: Scale tier used for estimation
  - `services` object[]
    - `vendor` string
    - `current_tier` string
    - `free_tier_limits` string
    - `conditions` object[]: A list of the conditions a vendor attaches to using its free tier. Each item holds our sentence (text), the vendor's own words (quote), the page that states them (url) and the date we read that page (read_on). An optional list rules_out names the uses the vendor excludes: "production", "commercial use" or both. Our re-reads of the vendor's pricing page do not change this field.
      - `text` string, required
      - `quote` string, required
      - `url` string, uri, required
      - `read_on` string, date, required
      - `rules_out` string[]
    - `estimated_monthly_cost` string
    - `free_alternative` object
      - `vendor` string
      - `tier` string
      - `description` string
      - `conditions` object[]: A list of the conditions a vendor attaches to using its free tier. Each item holds our sentence (text), the vendor's own words (quote), the page that states them (url) and the date we read that page (read_on). An optional list rules_out names the uses the vendor excludes: "production", "commercial use" or both. Our re-reads of the vendor's pricing page do not change this field.
        - `text` string, required
        - `quote` string, required
        - `url` string, uri, required
        - `read_on` string, date, required
        - `rules_out` string[]
    - `recent_changes` string[]
  - `total_estimated_cost` string
  - `savings_available` string
  - `warnings` string[]
  - `_provenance` Provenance: Where the figures in this response came from and how to attribute them. Every response carrying index data has one, under the key `_provenance`. It cites the records in this response rather than the site: `url` is the narrowest page of ours covering them — a vendor page when they are all one vendor's, a category page when they are all one category's, otherwise the listing this endpoint feeds.
    - `source` string, required: Always AgentDeals.
    - `url` string, uri, required: The page of ours that covers the records in this response.
    - `checked` string, date: The oldest verification date among the records cited here, so the citation is never dated younger than its weakest figure. Absent when no record in the response carries a date.
    - `verified` string, date: The same day as `checked`, absent for the same reason.
    - `cite_as` string, required: A citation line naming the source, the url and the date, ready to reproduce as it stands.
    - `verified_records` integer, required: How many records in this response we rank — the population this citation vouches for.
    - `withheld_records` integer: How many records in this response we return without vouching for: those carrying a `gate`, superseded terms, or a withheld risk level. Absent when there are none.
    - `note` string, required: The request to cite a figure back to where it came from.
    - `gated_note` string: Present whenever `withheld_records` is, stating that the citation does not extend to terms we did not publish.
    - `this_is_a_request_not_an_instruction` string: Present on responses that ask something of the caller, saying the ask is left to the caller and its user rather than imposed on them.

## Other responses

- `400`: Missing services parameter or invalid scale

---

[API](https://skmtc.dev/agentdeals/apis/agentdeals-api.md) · [All operations](https://skmtc.dev/agentdeals/apis/agentdeals-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentdeals/apis/agentdeals-api/revisions/2b80deacb326?raw)