---
title: "Paid history"
method: GET
path: "/v1/account"
---

# Paid history

`GET /v1/account`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/account`
- Auth: API key in header `Authorization`

## Response `200`

Account

- object
  - `data` AccountData, required
    - `account_id` string, required
    - `email` string, required
    - `finds` Find[], required
      - `spec_version` 'find.v1'
      - `find_id` string, required
      - `parent_find_id` string, nullable, required
      - `query_id` string, required
      - `guest_id` string, required
      - `account_id` string, nullable, required
      - `project_id` string, nullable
      - `status` 'queued' | 'planning' | 'running' | 'completed' | 'partial' | 'failed' | 'canceled' | 'expired', required
      - `ast_hash` string, required
      - `spec` QueryAst
        - `target_requirement` TargetRequirement
          - `contract` 'target-source-assertion.v1'
          - `entity_kind` 'place' | 'creator' | 'organization' | 'storefront_product' | 'app_listing' | 'job_posting' | 'scholarly_work' | 'tender' | 'grant' | 'software_repository' | 'software_package' | 'dataset' | 'clinical_trial' | 'regulatory_document' | 'vulnerability' | 'book' | 'podcast' | 'web_page' | 'knowledge_entity' | 'person', required
          - `text` string, required
          - `reading_policy_sha256` string, required
          - `max_candidates` integer
          - `max_passages` integer
          - `max_context_chars` integer
          - `max_source_chars` integer
          - `timeout_ms` integer
          - `evidence_meaning` 'interpreted_published_assertion'
          - `prior_knowledge_authority` false
          - `modifies_typed_predicates` false
        - `semantic_binding` SemanticBinding
          - `spec_version` 'semantic_binding.v1'
          - `catalog_sha256` string, required
          - `target_id` string, required
          - `footprint_id` string, nullable
        - `spec_version` 'query_ast.v1'
        - `entity_type` 'local_business' | 'creator' | 'organization' | 'storefront_product' | 'app_listing' | 'job_posting' | 'scholarly_work' | 'tender' | 'grant' | 'software_repository' | 'software_package' | 'dataset' | 'clinical_trial' | 'regulatory_document' | 'vulnerability' | 'book' | 'podcast' | 'web_page' | 'knowledge_entity' | 'person', required
        - `limit` QueryLimit, required
          - `max` integer
          - `inferred` boolean
        - `discovery` Discovery, required
          - `geography_scope` 'worldwide.v1', nullable
          - `term` string, required
          - `platforms` string[]
          - `searches` string[]
          - `role_phrases` string[]
          - `seed_identifiers` object
        - `geo` Geo
          - `kind` 'country' | 'locality' | 'admin1', required
          - `query_label` string, required
          - `country_code` string, nullable
          - `admin1_code` string, nullable, required
          - `locality` string, nullable, required
          - `postal_code` string, nullable, required
          - `status` 'qualified' | 'ambiguous' | 'unqualified', required
          - `source` 'gazetteer' | 'catalog' | 'alias' | 'well_formed', required
          - `geoname_id` integer, nullable
          - `near` Near: A distance from a point: "within 65 miles of 1417 E Fedora Ave, Fresno".
            - `point` string, required
            - `latitude` number, required
            - `longitude` number, required
            - `radius_km` number, required
        - `where` Predicate[], required
          - `field_id` string, required
          - `op` 'count_matches' | 'contains' | 'not_contains' | 'has_any' | 'has_all' | 'has_none' | 'before' | 'after' | 'on_or_before' | 'on_or_after' | 'gt' | 'lt' | 'ne' | 'not_in' | 'gte' | 'lte' | 'eq' | 'exists' | 'class_in' | 'in', required
          - `value` union, required
            - boolean
            - integer
            - number
            - string
            - string[]
            - CountMatches
              - …
        - `match_expression` MatchExpression: Explicit logical scope; leaves remain ordinary source-verifiable predicates.
          - `op` 'all' | 'any' | 'not', required
          - `clauses` union[], required
            - union
              - …
        - `output_fields` OutputField[]
          - `field_id` string, required
          - `required` boolean
        - `worded_conditions` WordedCondition[]
          - `condition_id` string, required
          - `words` string, required
          - `statement` string, required
          - `search_words` string
        - `worded_outputs` WordedOutput[]
          - `detail_id` string, required
          - `words` string, required
          - `description` string, required
          - `value_type` 'text' | 'number' | 'date' | 'url' | 'email' | 'phone' | 'yes_no'
          - `required` boolean
        - `sort` SortKey[], required
          - `field_id` string, required
          - `direction` 'asc' | 'desc', required
        - `locale` string, required
        - `inferred` InferredClause[], required
          - `field_id` string, required
          - `reason` string, required
        - `unsupported` UnsupportedClause[], required
          - `field_id` string, required
          - `op` 'count_matches' | 'contains' | 'not_contains' | 'has_any' | 'has_all' | 'has_none' | 'before' | 'after' | 'on_or_before' | 'on_or_after' | 'gt' | 'lt' | 'ne' | 'not_in' | 'gte' | 'lte' | 'eq' | 'exists' | 'class_in' | 'in', required
          - `value` union, required
            - boolean
            - integer
            - number
            - string
            - string[]
            - CountMatches
              - …
          - `reason` string, required
      - `operation` FindOperation
        - `operation` 'extend' | 'refresh' | 'add_facts', required
        - `parent_find_id` string, required
        - `root_find_id` string, required
        - `parent_snapshot_id` string, required
        - `context_hash` string, required
      - `revisit` RevisitSummary
        - `targets` integer, required
        - `checked` integer, required
        - `verified` integer, required
        - `no_longer_matches` integer, required
        - `unresolved` integer, required
        - `unavailable` integer, required
        - `not_reached` integer, required
        - `delivered` integer, required
        - `missing_required_details` object
      - `requested_count` integer, required
      - `accepted_count` integer, required
      - `stop_reason` 'complete_target' | 'saturated_discovery' | 'budget_reserved_exhausted' | 'wall_clock' | 'fetch_count' | 'source_blocked' | 'unsupported_predicate' | 'zero_after_filters' | 'user_cancel' | 'capacity', required
      - `error_code` 'unsupported_query' | 'unsupported_predicate' | 'unsupported_entity_family' | 'ambiguous_geo' | 'capability_pending' | 'source_blocked' | 'challenge_page' | 'unquoted_plan' | 'compiler_unavailable' | 'parse_failed' | 'payments_not_live' | 'capacity' | 'kill_switch' | 'internal_failure' | 'plan_required', required
      - `immutable` boolean, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `expires_at` string, date-time, nullable, required
      - `commerce` CommerceData
        - `spec_version` 'commerce.v1'
        - `find_id` string, required
        - `payment_status` string, required
        - `fulfillment_status` string, required
        - `settlement_status` 'none' | 'pending' | 'settled' | 'attention', required
        - `access_state` string, required
        - `access_allowed` boolean, required
        - `next_action` 'wait' | 'retrieve' | 'contact_support' | 'none', required
        - `currency` 'USD'
        - `amount_authorized_cents` integer, required
        - `amount_captured_cents` integer, required
        - `amount_refunded_cents` integer, required
        - `delivered_rows` integer, required
        - `fulfilled_at` string, date-time, nullable, required
        - `access_expires_at` string, date-time, nullable, required
        - `cancel_requested` boolean, required
        - `capacity_offer` CapacityQuoteData, required
          - `pricing_version` 'capacity.v1'
          - `quote_id` string, required
          - `quote_hash` string, required
          - `currency` 'USD' | 'EUR'
          - `maximum_cents` integer, required
          - `expires_at` string, date-time, required
          - `scope` object, required
          - `terms` object, required
            - `unit_cents` integer
            - `contact_unit_cents` integer: Rate for a result delivered with a requested email (or a phone when no phone rate is set); the maximum assumes every result has a contact.
            - `contact_phone_unit_cents` integer: Rate for a result delivered with a requested phone.
            - `check_unit_cents` integer: Charge per imported row resolved and checked, matched or not.
            - `required_check_unit_cents` integer: Charge per company checked for a detail marked as needed that met every condition but lacked it.
            - `required_check_allowance` integer: How many such companies the maximum covers.
            - `related_block_cents` integer: Charge per ten related records past related_included_records in one collection on one result.
            - `undelivered_unit_cents` integer: Missing-result shortfall refund per unit, excluding unused contact contingency.
            - `retail_rate` object
              - …
          - `cost_basis` 'estimated' | 'measured', required
          - `cost_profile_version` string, required
          - `retained_work_cents` 0
          - `existing_execution` object, nullable
          - `can_authorize` boolean
        - `billing_model` 'capacity.v1'
        - `reservation_id` string, required
        - `billed_unit_ids` string[]
        - `billed_units` BilledUnit[]
          - `id` string, required
          - `unit_cents` integer, required
        - `shortfall` Shortfall: A Find that came back short: what was found is delivered, the rest refunded.
          - `requested_units` integer, required
          - `delivered_units` integer, required
          - `refunded_cents` integer, required
      - `queue_position` integer, nullable
      - `missing_required_details` object

## Other responses

- `default`: Error envelope

---

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