{"openapi":"3.1.0","info":{"title":"StartupSeeker API","version":"4.0.0","description":"Startup, investor, funding-round and exit data. Docs: https://startup-seeker.com/api-docs"},"servers":[{"url":"https://startup-seeker.com/api/v4"}],"security":[{"apiKey":[]}],"tags":[{"name":"Records"},{"name":"Reference data"},{"name":"Account"},{"name":"Lists"},{"name":"Exports"},{"name":"Enrichments"},{"name":"Corrections"},{"name":"Webhooks"}],"paths":{"/{collection}/search":{"post":{"operationId":"search","summary":"Search records","description":"Find records with a filter, an explicit sort, or semantic ranking (startups). Pages shrink to fit 1 MB; continue by sending only page.next_cursor.\n\nPrice: 1¢ per successful request.","tags":["Records"],"parameters":[{"name":"collection","in":"path","required":true,"description":"startups, investors, funding_rounds or exits.","schema":{"type":"string","enum":["startups","investors","funding_rounds","exits"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"description":"v4 filter object. Sibling keys AND; see the Filters guide.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"query":{"description":"Startups only: rank by meaning (semantic search). Replaces sort.","type":"string","minLength":1,"maxLength":2000},"similar_to":{"description":"Startups only: rank look-alikes of this startup (domain or UUID). Replaces sort.","type":"string","minLength":1,"maxLength":2048},"sort":{"description":"Up to three field names; prefix \"-\" for descending. NULL sorts last; id breaks ties.","maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"fields":{"description":"Fields to return. Omit for the default fields. id is always returned.","maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"expand":{"description":"Related records to nest, e.g. [\"funding_rounds\",\"investors\"]. See /schema for per-record caps.","maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"focus":{"description":"Investors only: rank by sector specialisation, e.g. {\"industries\":[\"fintech\"]}. Adds focus_count, focus_total, focus_share, focus_score.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"limit":{"description":"Rows per page, 1–100 (default 25). Pages also shrink to fit 1 MB.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"page.next_cursor from the previous page. Send only the cursor (and optionally limit) to continue.","type":"string","minLength":1,"maxLength":9000}},"additionalProperties":false},"example":{"filter":{"hq_country":"DE","industries":{"any":["fintech"]},"total_funding_usd":{"gte":1000000}},"fields":["name","domain","total_funding_usd"],"sort":["-total_funding_usd"],"limit":2}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."}},"required":["id"],"additionalProperties":{},"description":"A record with the requested fields (see /schema). Expanded to-many relations are page objects {data, page}; to-one relations are objects or null."}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."},"applied_filter":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}],"description":"The filter that ran, after normalisation, in v4 grammar."},"search_id":{"description":"Semantic searches: handle for POST /exports {search_id}; valid 30 minutes.","type":["string","null"]},"search_expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"ranking":{"description":"Semantic searches only. Ranking is approximate and never exhaustive.","type":"object","properties":{"type":{"type":"string","const":"semantic"},"coverage":{"anyOf":[{"type":"string","enum":["within_filter","post_filtered"]},{"type":"null"}],"description":"within_filter: every startup the filter allows was ranked. post_filtered: more than 10,000 startups matched, so ranking is approximate; strong matches can be missed."},"population":{"description":"Startups the filter allows (when known).","type":["number","null"]},"ranked":{"description":"Candidates that were ranked.","type":["number","null"]},"unranked":{"description":"Allowed startups without a semantic profile, so not ranked.","type":["number","null"]},"dropped":{"type":"number","description":"Ranked rows on this page that no longer exist."}},"required":["type","coverage","population","ranked","unranked","dropped"],"additionalProperties":false},"focus":{"description":"Investors with focus: the sectors and how focus_score ranks them.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"diagnostics":{"description":"For empty results: which conditions removed the most records."},"match_scope":{"description":"Investors: independent_firm_facets when stage, sector and geography are matched separately, not as one joint strategy.","type":"string"}},"required":["request_id","cost_usd_cents","applied_filter"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract. UNKNOWN_FIELD: A field name is not part of this collection. OPERATOR_NOT_SUPPORTED: The operator is not available for this field. TAG_ARRAY_NEEDS_OPERATOR: A bare array was given for a tag field. VALUE_UNKNOWN: A filter value does not match any known value. VALUE_AMBIGUOUS: A friendly filter value matches several canonical values. QUERY_TOO_COMPLEX: The filter exceeds the complexity limits. SEMANTIC_NOT_SUPPORTED: Semantic ranking (query / similar_to) is only available for startups. CURSOR_INVALID: The cursor is malformed, belongs to another query or another account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"CURSOR_EXPIRED: The cursor expired (24 h, or 30 min for semantic rankings).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"RECORD_TOO_LARGE: A single record exceeds the 1 MB response budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"QUERY_TIMEOUT: The query ran out of its time budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/{collection}/{ref}":{"get":{"operationId":"get","summary":"Get a record","description":"One record by UUID, domain, slug or LinkedIn URL (funding rounds and exits: UUID). expand nests related records with their own pagination.\n\nPrice: 1¢ per successful request.","tags":["Records"],"parameters":[{"name":"collection","in":"path","required":true,"description":"startups, investors, funding_rounds or exits.","schema":{"type":"string","enum":["startups","investors","funding_rounds","exits"]}},{"name":"ref","in":"path","required":true,"description":"UUID, domain, slug or LinkedIn URL (percent-encode URLs).","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated.","schema":{"type":"string"},"style":"form","explode":false},{"name":"expand","in":"query","required":false,"description":"Comma-separated.","schema":{"type":"string"},"style":"form","explode":false}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."}},"required":["id"],"additionalProperties":{},"description":"A record with the requested fields (see /schema). Expanded to-many relations are page objects {data, page}; to-one relations are objects or null."},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract. UNKNOWN_FIELD: A field name is not part of this collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"REF_AMBIGUOUS: The ref matches several records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"RECORD_TOO_LARGE: A single record exceeds the 1 MB response budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"QUERY_TIMEOUT: The query ran out of its time budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/{collection}/{id}/{relation}":{"get":{"operationId":"relation","summary":"List related records","description":"Page through one relation of a record (e.g. a startup's funding_rounds or an investor's portfolio) by the parent's UUID.\n\nPrice: 1¢ per successful request.","tags":["Records"],"parameters":[{"name":"collection","in":"path","required":true,"description":"startups, investors, funding_rounds or exits.","schema":{"type":"string","enum":["startups","investors","funding_rounds","exits"]}},{"name":"id","in":"path","required":true,"description":"Parent record UUID.","schema":{"type":"string"}},{"name":"relation","in":"path","required":true,"description":"A to-many relation listed under expand in /schema.","schema":{"type":"string"}},{"name":"fields","in":"query","required":false,"description":"Comma-separated.","schema":{"type":"string"},"style":"form","explode":false},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract. CURSOR_INVALID: The cursor is malformed, belongs to another query or another account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"CURSOR_EXPIRED: The cursor expired (24 h, or 30 min for semantic rankings).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"RECORD_TOO_LARGE: A single record exceeds the 1 MB response budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"QUERY_TIMEOUT: The query ran out of its time budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/{collection}/match":{"post":{"operationId":"match","summary":"Match refs and names","description":"Up to 100 domains, UUIDs, LinkedIn URLs or names in one call. One result per input, in input order: exact, candidates, not_found or invalid. Names never become exact.\n\nPrice: 1¢ per successful request.","tags":["Records"],"parameters":[{"name":"collection","in":"path","required":true,"description":"startups, investors, funding_rounds or exits.","schema":{"type":"string","enum":["startups","investors","funding_rounds","exits"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"values":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":2048},"description":"Domains, UUIDs, slugs, LinkedIn URLs or names (names: startups and investors only)."},"fields":{"description":"Fields for exact matches. Omit for the default fields.","maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}}},"required":["values"],"additionalProperties":false},"example":{"values":["stripe.com","Mistral AI"],"fields":["name","domain"]}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"input":{"type":"string"},"status":{"type":"string","enum":["exact","candidates","not_found","invalid"]},"record":{"description":"For exact matches.","type":"object","properties":{"id":{"type":"string","description":"UUID."}},"required":["id"],"additionalProperties":{}},"candidates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"name":{"type":["string","null"]},"domain":{"type":["string","null"]},"confidence":{"type":["number","null"]}},"required":["id"],"additionalProperties":{}}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["input","status"],"additionalProperties":false}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract. UNKNOWN_FIELD: A field name is not part of this collection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/{collection}/aggregate":{"post":{"operationId":"aggregate","summary":"Count and summarise","description":"Exact counts and metrics, optionally grouped by up to two fields (dates by year, quarter or month). Columns carry real names; the top 100 groups are returned.\n\nPrice: 1¢ per successful request.","tags":["Records"],"parameters":[{"name":"collection","in":"path","required":true,"description":"startups, investors, funding_rounds or exits.","schema":{"type":"string","enum":["startups","investors","funding_rounds","exits"]}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filter":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"group_by":{"description":"Up to two fields; dates as {\"field\":\"announced_at\",\"bucket\":\"quarter\"}. Funding rounds can group by \"investor\"; exits by \"acquirer\".","maxItems":2,"type":"array","items":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":100},"bucket":{"type":"string","enum":["year","quarter","month"]}},"required":["field","bucket"],"additionalProperties":false}]}},"metrics":{"description":"Default [\"count\"]. Others: {\"sum\":\"amount_usd\"}, {\"avg\":…}, {\"min\":…}, {\"max\":…}, {\"count_distinct\":…}; add \"as\" to name the column.","minItems":1,"maxItems":10,"type":"array","items":{"anyOf":[{"type":"string","const":"count"},{"type":"object","properties":{"count_distinct":{"type":"string"},"sum":{"type":"string"},"avg":{"type":"string"},"min":{"type":"string"},"max":{"type":"string"},"count":{"type":"boolean","const":true},"as":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$"}},"additionalProperties":false}]}},"sort":{"description":"Output column names; \"-\" for descending. Default: first metric descending.","maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"limit":{"description":"Top groups to return, 1–100 (default 100).","type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"example":{"filter":{"announced_at":{"gte":"-12m"}},"group_by":["hq_country"],"metrics":["count",{"sum":"amount_usd","as":"raised_usd"}],"sort":["-raised_usd"],"limit":5}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."},"applied_filter":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"records":{"type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false,"description":"Records matching the filter."},"groups":{"type":"object","properties":{"returned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"complete":{"type":"boolean"}},"required":["returned","total","complete"],"additionalProperties":false,"description":"Aggregates return the top groups; complete is false when groups were left out."},"groups_overlap":{"description":"true for tag or investor groupings: a record can be in several groups, so sums are not additive.","type":"boolean"},"totals":{"description":"count and sum across all matching records (scalar groupings only).","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"match_scope":{"type":"string"}},"required":["request_id","cost_usd_cents","applied_filter","records","groups"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract. UNKNOWN_FIELD: A field name is not part of this collection. OPERATOR_NOT_SUPPORTED: The operator is not available for this field. VALUE_UNKNOWN: A filter value does not match any known value. VALUE_AMBIGUOUS: A friendly filter value matches several canonical values. QUERY_TOO_COMPLEX: The filter exceeds the complexity limits. COLUMN_NAME_CONFLICT: Two aggregate columns would have the same name.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"QUERY_TIMEOUT: The query ran out of its time budget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/schema":{"get":{"operationId":"schema","summary":"Schema","description":"Fields, types, filter operators, sortable and groupable fields and expandable relations for every collection. Free and public; cache for an hour.\n\nPrice: free.","tags":["Reference data"],"security":[],"parameters":[],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/schema/{collection}":{"get":{"operationId":"schema_collection","summary":"Schema for one collection","description":"The schema of one collection; add ?fields=a,b for just those fields.\n\nPrice: free.","tags":["Reference data"],"security":[],"parameters":[{"name":"collection","in":"path","required":true,"description":"startups, investors, funding_rounds or exits.","schema":{"type":"string","enum":["startups","investors","funding_rounds","exits"]}},{"name":"fields","in":"query","required":false,"description":"Comma-separated.","schema":{"type":"string"},"style":"form","explode":false}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/industries":{"get":{"operationId":"industries","summary":"Industries","description":"Industry slugs and names, and the industry groups (\"group:climate\") that expand to several slugs. Free and public.\n\nPrice: free.","tags":["Reference data"],"security":[],"parameters":[],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"groups":{"type":"array","items":{"type":"string"}}},"required":["slug","name","groups"],"additionalProperties":false}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."},"groups":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"industries":{"type":"array","items":{"type":"string"}}},"required":["name","industries"],"additionalProperties":false}}},"required":["request_id","cost_usd_cents","groups"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/locations":{"get":{"operationId":"locations","summary":"Find locations","description":"Resolve a place name to the country, region, state or GeoNames city ids that filters use. Free.\n\nPrice: free.","tags":["Reference data"],"parameters":[{"name":"q","in":"query","required":true,"description":"","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/account":{"get":{"operationId":"account","summary":"Account balance and quotas","description":"Available and reserved balance, daily quotas with usage and reset times, and enrichment spend limits. Free.\n\nPrice: free.","tags":["Account"],"parameters":[],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"balance":{"type":"object","properties":{"available_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["available_usd_cents","reserved_usd_cents"],"additionalProperties":false},"quotas":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"note":{"type":"string"}},"required":["balance","quotas","note"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/linkedin":{"get":{"operationId":"linkedin","summary":"Read a LinkedIn page","description":"The public text of a LinkedIn company or profile page. Calls an external provider: 2¢ per call.\n\nPrice: 2¢ per successful request.","tags":["Reference data"],"parameters":[{"name":"url","in":"query","required":true,"description":"","schema":{"type":"string","maxLength":2048,"format":"uri"}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"url":{"type":"string"},"kind":{"type":"string","enum":["company","profile"]},"text":{"type":"string"}},"required":["url","kind","text"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":2}},"/lists":{"get":{"operationId":"list_lists","summary":"List saved lists","description":"Your saved lists, default list first, then most recently active.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"name":{"type":"string"},"description":{"type":["string","null"]},"is_default":{"type":"boolean"},"item_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","name","description","is_default","item_count","created_at","updated_at"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1},"post":{"operationId":"create_list","summary":"Create a list","description":"Create a saved list.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":150},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"required":["name"],"additionalProperties":false},"example":{"name":"Berlin fintech","description":"Seed to Series A"}}}},"responses":{"201":{"description":"Created.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"name":{"type":"string"},"description":{"type":["string","null"]},"is_default":{"type":"boolean"},"item_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","name","description","is_default","item_count","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/lists/{id}":{"get":{"operationId":"get_list","summary":"Get a list","description":"A list with its item count.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"id","in":"path","required":true,"description":"List UUID.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"name":{"type":"string"},"description":{"type":["string","null"]},"is_default":{"type":"boolean"},"item_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","name","description","is_default","item_count","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1},"patch":{"operationId":"update_list","summary":"Update a list","description":"Rename a list or change its description.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"id","in":"path","required":true,"description":"List UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":150},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]}},"additionalProperties":false},"example":{"name":"Berlin fintech 2026"}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"name":{"type":"string"},"description":{"type":["string","null"]},"is_default":{"type":"boolean"},"item_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","name","description","is_default","item_count","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1},"delete":{"operationId":"delete_list","summary":"Delete a list","description":"Delete a list and its items.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"id","in":"path","required":true,"description":"List UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"deleted":{"type":"boolean","const":true}},"required":["id","deleted"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/lists/{id}/items":{"get":{"operationId":"list_items","summary":"List items","description":"Items in the order they were added, with name, HQ country and a short description.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"id","in":"path","required":true,"description":"List UUID.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"startup_id":{"anyOf":[{"type":"string","description":"UUID."},{"type":"null"}]},"domain":{"type":"string"},"name":{"type":["string","null"]},"hq_country":{"type":["string","null"]},"description":{"type":["string","null"]},"added_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."}},"required":["id","startup_id","domain","name","hq_country","description","added_at"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1},"post":{"operationId":"add_items","summary":"Add items","description":"Add up to 100 startups (UUIDs or domains). Items already on the list are counted, not duplicated.\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"id","in":"path","required":true,"description":"List UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":2048},"description":"Startup UUIDs or domains."}},"required":["items"],"additionalProperties":false},"example":{"items":["stripe.com","mistral.ai"]}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"list_id":{"type":"string","description":"UUID."},"added":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"already_present":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"item_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["list_id","added","already_present","item_count"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/lists/{id}/items/remove":{"post":{"operationId":"remove_items","summary":"Remove items","description":"Remove up to 100 startups (UUIDs or domains).\n\nPrice: 1¢ per successful request.","tags":["Lists"],"parameters":[{"name":"id","in":"path","required":true,"description":"List UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":2048},"description":"Startup UUIDs or domains."}},"required":["items"],"additionalProperties":false},"example":{"items":["stripe.com"]}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"list_id":{"type":"string","description":"UUID."},"removed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"item_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["list_id","removed","item_count"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":1}},"/exports":{"post":{"operationId":"create_export","summary":"Create an export","description":"Quote a CSV or JSONL file of a search (or of a semantic search by search_id). The job waits for approval; a 0¢ quote starts at once.\n\nPrice: free.","tags":["Exports"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"collection":{"type":"string","enum":["startups","investors","funding_rounds","exits"]},"search_id":{"description":"meta.search_id of a semantic search: exports exactly that ranking, with its filter, fields and expands.","type":"string","minLength":1,"maxLength":9000},"filter":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"sort":{"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"fields":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"expand":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"focus":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"format":{"type":"string","enum":["csv","jsonl"]},"client_reference":{"description":"Your own reference (≤200 chars). Filter job lists by it to find work again.","type":"string","minLength":1,"maxLength":200}},"required":["format"],"additionalProperties":false},"example":{"collection":"startups","filter":{"hq_country":"BE"},"fields":["name","domain","total_funding_usd"],"format":"csv","client_reference":"be-startups"}}}},"responses":{"202":{"description":"Accepted; the job continues in the background.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"export"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"client_reference":{"type":["string","null"]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"collection":{},"format":{},"quote":{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The most approval can charge."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","rows","max_cost_usd_cents","expires_at","lines"],"additionalProperties":false},"progress":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows"],"additionalProperties":false},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"result":{"anyOf":[{"type":"object","properties":{"download_url":{"type":["string","null"]},"url_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"artifact_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"filename":{"type":"string"},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated_to_quote":{"type":"boolean"},"note":{"type":"string"}},"required":["download_url","artifact_expires_at","rows"],"additionalProperties":false},{"type":"null"}]},"failure":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":["string","null"]}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","client_reference","created_at","finished_at","collection","format","quote","progress","cost","result","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract. UNKNOWN_FIELD: A field name is not part of this collection. VALUE_UNKNOWN: A filter value does not match any known value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"SEARCH_EXPIRED: The ranked search (search_id) expired after 30 minutes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0},"get":{"operationId":"list_exports","summary":"List exports","description":"Your exports, newest first; filter by client_reference.\n\nPrice: free.","tags":["Exports"],"parameters":[{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}},{"name":"client_reference","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"export"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"client_reference":{"type":["string","null"]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"collection":{},"format":{},"quote":{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The most approval can charge."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","rows","max_cost_usd_cents","expires_at","lines"],"additionalProperties":false},"progress":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows"],"additionalProperties":false},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"result":{"anyOf":[{"type":"object","properties":{"download_url":{"type":["string","null"]},"url_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"artifact_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"filename":{"type":"string"},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated_to_quote":{"type":"boolean"},"note":{"type":"string"}},"required":["download_url","artifact_expires_at","rows"],"additionalProperties":false},{"type":"null"}]},"failure":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":["string","null"]}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","client_reference","created_at","finished_at","collection","format","quote","progress","cost","result","failure"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/exports/{id}":{"get":{"operationId":"get_export","summary":"Get an export","description":"Status, quote, cost and, once succeeded, a 5-minute download link (renewed on every read). ?wait=10 waits for a change.\n\nPrice: free.","tags":["Exports"],"parameters":[{"name":"id","in":"path","required":true,"description":"Export UUID.","schema":{"type":"string"}},{"name":"wait","in":"query","required":false,"description":"Seconds to wait (0–10) for the status to change before answering.","schema":{"description":"Seconds to wait (0–10) for the status to change before answering.","type":"integer","minimum":0,"maximum":10}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"export"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"client_reference":{"type":["string","null"]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"collection":{},"format":{},"quote":{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The most approval can charge."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","rows","max_cost_usd_cents","expires_at","lines"],"additionalProperties":false},"progress":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows"],"additionalProperties":false},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"result":{"anyOf":[{"type":"object","properties":{"download_url":{"type":["string","null"]},"url_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"artifact_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"filename":{"type":"string"},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated_to_quote":{"type":"boolean"},"note":{"type":"string"}},"required":["download_url","artifact_expires_at","rows"],"additionalProperties":false},{"type":"null"}]},"failure":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":["string","null"]}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","client_reference","created_at","finished_at","collection","format","quote","progress","cost","result","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/exports/{id}/approve":{"post":{"operationId":"approve_export","summary":"Approve an export","description":"Start the export at its quoted price. Reserves quote.max_cost_usd_cents; actual rows are charged.\n\nPrice: free.","tags":["Exports"],"parameters":[{"name":"id","in":"path","required":true,"description":"Export UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"The quote_id you are approving. A stale id returns 409 QUOTE_EXPIRED with the new quote."}},"required":["quote_id"],"additionalProperties":false},"example":{"quote_id":"22222222-2222-4222-8222-222222222222"}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"export"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"client_reference":{"type":["string","null"]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"collection":{},"format":{},"quote":{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The most approval can charge."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","rows","max_cost_usd_cents","expires_at","lines"],"additionalProperties":false},"progress":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows"],"additionalProperties":false},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"result":{"anyOf":[{"type":"object","properties":{"download_url":{"type":["string","null"]},"url_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"artifact_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"filename":{"type":"string"},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated_to_quote":{"type":"boolean"},"note":{"type":"string"}},"required":["download_url","artifact_expires_at","rows"],"additionalProperties":false},{"type":"null"}]},"failure":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":["string","null"]}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","client_reference","created_at","finished_at","collection","format","quote","progress","cost","result","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. QUOTE_EXPIRED: The quote is older than 30 minutes or was replaced. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/exports/{id}/cancel":{"post":{"operationId":"cancel_export","summary":"Cancel an export","description":"Cancel an export; unspent reservations are refunded.\n\nPrice: free.","tags":["Exports"],"parameters":[{"name":"id","in":"path","required":true,"description":"Export UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"export"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"client_reference":{"type":["string","null"]},"created_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"collection":{},"format":{},"quote":{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The most approval can charge."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","rows","max_cost_usd_cents","expires_at","lines"],"additionalProperties":false},"progress":{"type":"object","properties":{"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rows"],"additionalProperties":false},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"result":{"anyOf":[{"type":"object","properties":{"download_url":{"type":["string","null"]},"url_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"artifact_expires_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"filename":{"type":"string"},"rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"truncated_to_quote":{"type":"boolean"},"note":{"type":"string"}},"required":["download_url","artifact_expires_at","rows"],"additionalProperties":false},{"type":"null"}]},"failure":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":["string","null"]}},"required":["code","message"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","client_reference","created_at","finished_at","collection","format","quote","progress","cost","result","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/enrichments":{"post":{"operationId":"create_enrichment","summary":"Create an enrichment","description":"Check up to 5,000 companies (free VC-backability check), then quote web updates of company details, funding or founders. A 0¢ quote starts on its own.\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"companies":{"anyOf":[{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"string","minLength":1,"maxLength":2048}},{"type":"object","properties":{"list_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"}},"required":["list_id"],"additionalProperties":false},{"type":"object","properties":{"csv":{"type":"string","minLength":1,"maxLength":16384}},"required":["csv"],"additionalProperties":false}],"description":"Domains (≤5,000), {\"list_id\": …} or {\"csv\": \"…\"} with a website/domain/url column."},"check_only":{"description":"Run only the free VC-backability check. The job succeeds after the check and has no quote.","type":"boolean"},"update":{"type":"object","properties":{"details":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"freshness":{"type":"string","enum":["12m","6m","30d","always"]}},"required":["freshness"],"additionalProperties":false}]},"funding":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"freshness":{"type":"string","enum":["12m","6m","30d","always"]}},"required":["freshness"],"additionalProperties":false}]},"founders":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"freshness":{"type":"string","enum":["12m","6m","30d","always"]}},"required":["freshness"],"additionalProperties":false}]}},"additionalProperties":false,"description":"Which data to refresh from the web. true = refresh data older than 6 months; {\"freshness\":\"12m\"|\"6m\"|\"30d\"|\"always\"}; false or omitted = keep StartupSeeker data."},"client_reference":{"description":"Your own reference (≤200 chars). Filter job lists by it to find work again.","type":"string","minLength":1,"maxLength":200}},"required":["companies"],"additionalProperties":false},"example":{"companies":["acme.com","beta.io"],"update":{"funding":{"freshness":"30d"}},"client_reference":"crm-sync-42"}}}},"responses":{"202":{"description":"Accepted; the job continues in the background.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"enrichment"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"check_only":{"type":"boolean"},"client_reference":{"type":["string","null"]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"update":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean"},"freshness":{"type":"string"},"refresh_older_than_days":{"type":["number","null"]}},"required":["enabled","freshness","refresh_older_than_days"],"additionalProperties":false}},{"type":"null"}]},"progress":{"type":"object","properties":{"companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vc_backable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issues":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["companies","checked","vc_backable","ready","issues"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"new_companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","max_cost_usd_cents","expires_at","new_companies","lines"],"additionalProperties":false},{"type":"null"}]},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"failure":{"anyOf":[{"type":"object","properties":{"stage":{"type":"string","enum":["check","run"]}},"required":["stage"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","check_only","client_reference","created_at","finished_at","update","progress","quote","cost","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"FORBIDDEN: This key or application may not perform the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window. QUOTA_EXCEEDED: A daily or concurrency quota is used up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0},"get":{"operationId":"list_enrichments","summary":"List enrichments","description":"Your enrichment jobs, newest first; filter by client_reference.\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}},{"name":"client_reference","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"enrichment"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"check_only":{"type":"boolean"},"client_reference":{"type":["string","null"]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"update":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean"},"freshness":{"type":"string"},"refresh_older_than_days":{"type":["number","null"]}},"required":["enabled","freshness","refresh_older_than_days"],"additionalProperties":false}},{"type":"null"}]},"progress":{"type":"object","properties":{"companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vc_backable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issues":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["companies","checked","vc_backable","ready","issues"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"new_companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","max_cost_usd_cents","expires_at","new_companies","lines"],"additionalProperties":false},{"type":"null"}]},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"failure":{"anyOf":[{"type":"object","properties":{"stage":{"type":"string","enum":["check","run"]}},"required":["stage"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","check_only","client_reference","created_at","finished_at","update","progress","quote","cost","failure"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/enrichments/{id}":{"get":{"operationId":"get_enrichment","summary":"Get an enrichment","description":"Status, progress, quote and cost. ?wait=10 waits for a change.\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Enrichment UUID.","schema":{"type":"string"}},{"name":"wait","in":"query","required":false,"description":"Seconds to wait (0–10) for the status to change before answering.","schema":{"description":"Seconds to wait (0–10) for the status to change before answering.","type":"integer","minimum":0,"maximum":10}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"enrichment"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"check_only":{"type":"boolean"},"client_reference":{"type":["string","null"]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"update":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean"},"freshness":{"type":"string"},"refresh_older_than_days":{"type":["number","null"]}},"required":["enabled","freshness","refresh_older_than_days"],"additionalProperties":false}},{"type":"null"}]},"progress":{"type":"object","properties":{"companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vc_backable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issues":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["companies","checked","vc_backable","ready","issues"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"new_companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","max_cost_usd_cents","expires_at","new_companies","lines"],"additionalProperties":false},{"type":"null"}]},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"failure":{"anyOf":[{"type":"object","properties":{"stage":{"type":"string","enum":["check","run"]}},"required":["stage"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","check_only","client_reference","created_at","finished_at","update","progress","quote","cost","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0},"patch":{"operationId":"configure_enrichment","summary":"Change what to update","description":"Change update before approval. Returns a new quote without re-running the check.\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Enrichment UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"update":{"type":"object","properties":{"details":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"freshness":{"type":"string","enum":["12m","6m","30d","always"]}},"required":["freshness"],"additionalProperties":false}]},"funding":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"freshness":{"type":"string","enum":["12m","6m","30d","always"]}},"required":["freshness"],"additionalProperties":false}]},"founders":{"anyOf":[{"type":"boolean"},{"type":"object","properties":{"freshness":{"type":"string","enum":["12m","6m","30d","always"]}},"required":["freshness"],"additionalProperties":false}]}},"additionalProperties":false,"description":"Which data to refresh from the web. true = refresh data older than 6 months; {\"freshness\":\"12m\"|\"6m\"|\"30d\"|\"always\"}; false or omitted = keep StartupSeeker data."}},"required":["update"],"additionalProperties":false},"example":{"update":{"details":true,"funding":{"freshness":"always"}}}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"enrichment"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"check_only":{"type":"boolean"},"client_reference":{"type":["string","null"]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"update":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean"},"freshness":{"type":"string"},"refresh_older_than_days":{"type":["number","null"]}},"required":["enabled","freshness","refresh_older_than_days"],"additionalProperties":false}},{"type":"null"}]},"progress":{"type":"object","properties":{"companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vc_backable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issues":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["companies","checked","vc_backable","ready","issues"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"new_companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","max_cost_usd_cents","expires_at","new_companies","lines"],"additionalProperties":false},{"type":"null"}]},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"failure":{"anyOf":[{"type":"object","properties":{"stage":{"type":"string","enum":["check","run"]}},"required":["stage"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","check_only","client_reference","created_at","finished_at","update","progress","quote","cost","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. JOB_NOT_CONFIGURABLE: The job can no longer be reconfigured. CHECK_ONLY_JOB: A check-only enrichment has nothing to approve or configure. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/enrichments/{id}/approve":{"post":{"operationId":"approve_enrichment","summary":"Approve an enrichment","description":"Start the updates at the quoted price. Reserves quote.max_cost_usd_cents; only updates that succeed are charged.\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Enrichment UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"The quote_id you are approving. A stale id returns 409 QUOTE_EXPIRED with the new quote."}},"required":["quote_id"],"additionalProperties":false},"example":{"quote_id":"22222222-2222-4222-8222-222222222222"}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"enrichment"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"check_only":{"type":"boolean"},"client_reference":{"type":["string","null"]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"update":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean"},"freshness":{"type":"string"},"refresh_older_than_days":{"type":["number","null"]}},"required":["enabled","freshness","refresh_older_than_days"],"additionalProperties":false}},{"type":"null"}]},"progress":{"type":"object","properties":{"companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vc_backable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issues":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["companies","checked","vc_backable","ready","issues"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"new_companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","max_cost_usd_cents","expires_at","new_companies","lines"],"additionalProperties":false},{"type":"null"}]},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"failure":{"anyOf":[{"type":"object","properties":{"stage":{"type":"string","enum":["check","run"]}},"required":["stage"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","check_only","client_reference","created_at","finished_at","update","progress","quote","cost","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"INSUFFICIENT_FUNDS: The account balance cannot cover this request or job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"SPEND_LIMIT_EXCEEDED: A per-job or daily enrichment spend limit would be exceeded. FORBIDDEN: This key or application may not perform the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. QUOTE_EXPIRED: The quote is older than 30 minutes or was replaced. PRICE_CHANGED: The price rose since the quote was issued. QUOTE_NOT_READY: The job is still quoting. CHECK_ONLY_JOB: A check-only enrichment has nothing to approve or configure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/enrichments/{id}/cancel":{"post":{"operationId":"cancel_enrichment","summary":"Cancel an enrichment","description":"Cancel; work already running may finish and settle (status canceling).\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Enrichment UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"type":{"type":"string","const":"enrichment"},"status":{"type":"string","enum":["quoting","awaiting_approval","queued","running","canceling","succeeded","partially_succeeded","failed","canceled"]},"check_only":{"type":"boolean"},"client_reference":{"type":["string","null"]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"finished_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"update":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean"},"freshness":{"type":"string"},"refresh_older_than_days":{"type":["number","null"]}},"required":["enabled","freshness","refresh_older_than_days"],"additionalProperties":false}},{"type":"null"}]},"progress":{"type":"object","properties":{"companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"checked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vc_backable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ready":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issues":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["companies","checked","vc_backable","ready","issues"],"additionalProperties":false},"quote":{"anyOf":[{"type":"object","properties":{"quote_id":{"type":"string","description":"UUID."},"max_cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"expires_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"new_companies":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lines":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unit_price_micro_usd":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"1,000,000 = $1."},"cost_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"enabled":{"type":"boolean"},"eligible":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"missing":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"outdated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["item","quantity","unit_price_micro_usd","cost_usd_cents"],"additionalProperties":false}}},"required":["quote_id","max_cost_usd_cents","expires_at","new_companies","lines"],"additionalProperties":false},{"type":"null"}]},"cost":{"type":"object","properties":{"reserved_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"charged_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."},"refunded_usd_cents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"USD cents."}},"required":["reserved_usd_cents","charged_usd_cents","refunded_usd_cents"],"additionalProperties":false},"failure":{"anyOf":[{"type":"object","properties":{"stage":{"type":"string","enum":["check","run"]}},"required":["stage"],"additionalProperties":false},{"type":"null"}]}},"required":["id","type","status","check_only","client_reference","created_at","finished_at","update","progress","quote","cost","failure"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/enrichments/{id}/results":{"get":{"operationId":"enrichment_results","summary":"Enrichment results","description":"One row per company: check outcome, the StartupSeeker record and what was updated.\n\nPrice: free.","tags":["Enrichments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Enrichment UUID.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"outcome":{"type":"string","enum":["checking","vc_backable","unresolved","not_vc_backable","failed"]},"vc_backable":{"type":["boolean","null"]},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"company":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","description":"UUID."}},"required":["id"],"additionalProperties":{},"description":"A record with the requested fields (see /schema). Expanded to-many relations are page objects {data, page}; to-one relations are objects or null."},{"type":"null"}]},"updates":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"failures":{"type":"array","items":{"type":"string"}},"message":{"type":["string","null"]}},"required":["domain","outcome","vc_backable","name","description","company","updates","failures","message"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/corrections":{"post":{"operationId":"create_correction","summary":"Submit a correction","description":"Propose a source-backed fix to a record. It is verified against the source; read it back for the decision.\n\nPrice: free.","tags":["Corrections"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"A source-backed correction: entity (UUID or domain), field, value and source_url. Field-specific value shapes are listed in the Corrections guide."},"example":{"entity":"stripe.com","field":"founded_year","value":2010,"source_url":"https://stripe.com/about"}}}},"responses":{"202":{"description":"Accepted; the job continues in the background.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"status":{"type":"string","enum":["pending","verifying","resolved"]},"decision":{"anyOf":[{"type":"string","enum":["approved","rejected","no_change"]},{"type":"null"}]},"reason":{"type":["string","null"]},"explanation":{"type":["string","null"]}},"required":["id","status","decision","reason","explanation"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"FORBIDDEN: This key or application may not perform the operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/corrections/{id}":{"get":{"operationId":"get_correction","summary":"Get a correction","description":"pending, verifying or resolved, with the decision and reason. ?wait=10 waits for a change.\n\nPrice: free.","tags":["Corrections"],"parameters":[{"name":"id","in":"path","required":true,"description":"Correction UUID.","schema":{"type":"string"}},{"name":"wait","in":"query","required":false,"description":"Seconds to wait (0–10) for the status to change before answering.","schema":{"description":"Seconds to wait (0–10) for the status to change before answering.","type":"integer","minimum":0,"maximum":10}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"status":{"type":"string","enum":["pending","verifying","resolved"]},"decision":{"anyOf":[{"type":"string","enum":["approved","rejected","no_change"]},{"type":"null"}]},"reason":{"type":["string","null"]},"explanation":{"type":["string","null"]}},"required":["id","status","decision","reason","explanation"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/webhooks":{"get":{"operationId":"list_webhooks","summary":"List webhooks","description":"Your webhook endpoints.\n\nPrice: free.","tags":["Webhooks"],"parameters":[],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"url":{"type":["string","null"]},"label":{"type":["string","null"]},"api_version":{"type":"string","enum":["v3","v4"]},"events":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"updated_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"signing_secret":{"description":"Returned on create and rotate only.","type":"string"},"previous_secret_valid_until":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","url","label","api_version","events","created_at","updated_at"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0},"post":{"operationId":"create_webhook","summary":"Create a webhook","description":"Register an HTTPS endpoint and the events it receives. The signing secret is returned once.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri","description":"Public HTTPS URL that receives POSTed events."},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"events":{"description":"Event types to receive (default [\"*\"]).","minItems":1,"maxItems":20,"type":"array","items":{"type":"string"}}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com/hooks/startupseeker","events":["export.*","enrichment.succeeded"]}}}},"responses":{"201":{"description":"Created.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"url":{"type":["string","null"]},"label":{"type":["string","null"]},"api_version":{"type":"string","enum":["v3","v4"]},"events":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"updated_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"signing_secret":{"description":"Returned on create and rotate only.","type":"string"},"previous_secret_valid_until":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","url","label","api_version","events","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/webhooks/{id}":{"get":{"operationId":"get_webhook","summary":"Get a webhook","description":"One webhook endpoint.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"url":{"type":["string","null"]},"label":{"type":["string","null"]},"api_version":{"type":"string","enum":["v3","v4"]},"events":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"updated_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"signing_secret":{"description":"Returned on create and rotate only.","type":"string"},"previous_secret_valid_until":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","url","label","api_version","events","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0},"patch":{"operationId":"update_webhook","summary":"Update a webhook","description":"Change the URL, label or subscribed events.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri"},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"events":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string"}}},"additionalProperties":false},"example":{"events":["*"]}}}},"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"url":{"type":["string","null"]},"label":{"type":["string","null"]},"api_version":{"type":"string","enum":["v3","v4"]},"events":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"updated_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"signing_secret":{"description":"Returned on create and rotate only.","type":"string"},"previous_secret_valid_until":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","url","label","api_version","events","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0},"delete":{"operationId":"delete_webhook","summary":"Delete a webhook","description":"Stop deliveries to this endpoint.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"deleted":{"type":"boolean","const":true}},"required":["id","deleted"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/webhooks/{id}/rotate_secret":{"post":{"operationId":"rotate_webhook_secret","summary":"Rotate the signing secret","description":"Issue a new secret. The previous one keeps signing (as a second v1) for 24 hours.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"url":{"type":["string","null"]},"label":{"type":["string","null"]},"api_version":{"type":"string","enum":["v3","v4"]},"events":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"updated_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."},"signing_secret":{"description":"Returned on create and rotate only.","type":"string"},"previous_secret_valid_until":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]}},"required":["id","url","label","api_version","events","created_at","updated_at"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/webhooks/{id}/test":{"post":{"operationId":"test_webhook","summary":"Send a test event","description":"Queue a signed webhook.test event.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"202":{"description":"Accepted; the job continues in the background.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"event_id":{"type":"string"},"delivery_id":{"type":"string","description":"UUID."},"status":{"type":"string","const":"pending"}},"required":["event_id","delivery_id","status"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/webhooks/{id}/deliveries":{"get":{"operationId":"list_deliveries","summary":"List deliveries","description":"Deliveries of the last 30 days with status, attempts and the last response.\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"description":"","schema":{"type":"string","minLength":1,"maxLength":9000}}],"responses":{"200":{"description":"OK.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"event_id":{"type":["string","null"]},"event_type":{"type":"string"},"subject_id":{"type":"string","description":"UUID."},"status":{"type":"string","enum":["pending","delivered","failed"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"max_attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_attempt_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"last_attempt_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"last_response_status":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"type":["string","null"]},"delivered_at":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp (UTC)."},{"type":"null"}]},"created_at":{"type":"string","description":"ISO 8601 timestamp (UTC)."}},"required":["id","event_id","event_type","subject_id","status","attempts","max_attempts","next_attempt_at","last_attempt_at","last_response_status","last_error","delivered_at","created_at"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"description":"Send it back (alone, optionally with limit) for the next page; null at the end.","type":["string","null"]},"total":{"description":"How many records match in total.","type":"object","properties":{"value":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Number of matching records; null when unknown."},"exact":{"type":"boolean","description":"false when value is a lower bound (≥10,000) or unknown."}},"required":["value","exact"],"additionalProperties":false},"shortened":{"description":"Present when the page was cut to fit 1 MB; next_cursor continues exactly after the last row.","type":"boolean","const":true}},"required":["next_cursor"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","page","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}},"/webhooks/{id}/deliveries/{delivery_id}/redeliver":{"post":{"operationId":"redeliver","summary":"Redeliver","description":"Send a delivery again now (one more attempt).\n\nPrice: free.","tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"description":"Webhook UUID.","schema":{"type":"string"}},{"name":"delivery_id","in":"path","required":true,"description":"Delivery UUID.","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Retrying with the same key and body replays the original response (free); a different body returns 409 IDEMPOTENCY_MISMATCH. Kept 24 hours.","schema":{"type":"string","maxLength":200}}],"responses":{"202":{"description":"Accepted; the job continues in the background.","headers":{"X-Request-Id":{"schema":{"type":"string"}},"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the window resets."},"Location":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"UUID."},"status":{"type":"string","const":"pending"}},"required":["id","status"],"additionalProperties":false},"meta":{"type":"object","properties":{"request_id":{"type":"string","description":"Request id (also in X-Request-Id)."},"cost_usd_cents":{"type":"number","description":"Charged for this request, in USD cents."}},"required":["request_id","cost_usd_cents"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"description":"VALIDATION_FAILED: The request does not match the endpoint contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"UNAUTHORIZED: The API key is missing, invalid or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"NOT_FOUND: The record or resource does not exist for this account.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"IDEMPOTENCY_MISMATCH: This Idempotency-Key was already used with a different request. IDEMPOTENCY_IN_PROGRESS: A request with this Idempotency-Key is still running. CONFLICT: The resource changed concurrently or already exists.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"RATE_LIMITED: Too many requests in the current window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"INTERNAL_ERROR: An unexpected server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"SERVICE_UNAVAILABLE: A dependency is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-price-usd-cents":0}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from https://startup-seeker.com/account/api-keys (ssk_live_…)."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_FAILED","UNKNOWN_FIELD","OPERATOR_NOT_SUPPORTED","TAG_ARRAY_NEEDS_OPERATOR","VALUE_UNKNOWN","VALUE_AMBIGUOUS","SEMANTIC_NOT_SUPPORTED","QUERY_TOO_COMPLEX","CURSOR_INVALID","COLUMN_NAME_CONFLICT","UNAUTHORIZED","METHOD_NOT_ALLOWED","INSUFFICIENT_FUNDS","FORBIDDEN","SPEND_LIMIT_EXCEEDED","NOT_FOUND","RECORD_REMOVED","REF_AMBIGUOUS","CONFLICT","QUOTE_EXPIRED","PRICE_CHANGED","QUOTE_NOT_READY","JOB_NOT_CONFIGURABLE","CHECK_ONLY_JOB","IDEMPOTENCY_MISMATCH","IDEMPOTENCY_IN_PROGRESS","CURSOR_EXPIRED","SEARCH_EXPIRED","BODY_TOO_LARGE","RECORD_TOO_LARGE","RATE_LIMITED","QUOTA_EXCEEDED","INTERNAL_ERROR","MUTATION_OUTCOME_UNKNOWN","SERVICE_UNAVAILABLE","QUERY_TIMEOUT"]},"message":{"type":"string"},"param":{"type":"string"},"hint":{"type":"string"},"retryable":{"type":"boolean"},"doc_url":{"type":"string"},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["code","message","retryable","doc_url"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}