{ "openapi": "3.1.0", "info": { "title": "Casafari High Potential Seller Leads API", "version": "2026-10-31.1", "summary": "High Potential Seller Leads. Built from the deduplicated property graph: homes whose asking price was cut repeatedly, around a point: leads for owners who may want to sell. Each lead carries only its property id, coordinates and price cuts, no property details; for those, pass its property_id to Property Sourcing's GET /v1/property-sourcing/properties/{property_id} (10 tokens). REST only. Not Private Seller Leads: those are new listings offered by their owners.", "description": "Casafari sells property data to people and AI agents through self-serve APIs and MCP servers. One account, one key and one balance of tokens work on every product. Tokens are the billing atom; every operation lists its cost in x-casafari-units. When tokens run out the API answers 402 with a payment link to top up." }, "servers": [ { "url": "https://platform.casafari.com" } ], "tags": [ { "name": "High Potential Seller Leads" } ], "externalDocs": { "url": "https://developers.casafari.com/docs" }, "paths": { "/v1/seller-leads": { "get": { "operationId": "seller_leads_list", "summary": "Seller leads list", "description": "Costs 100 tokens a call. Each page is a call. One search reaches at most 1000 results. Each lead is {id, property_id, coordinates, price_cuts, price_cuts_since}: the property id, its coordinates and its price reductions, no property details (type, price, size, address). For a lead's details, pass its property_id to Property Sourcing's GET /v1/property-sourcing/properties/{property_id} (10 tokens).", "tags": [ "High Potential Seller Leads" ], "security": [ { "apiKeyBearer": [] }, { "apiKeyHeader": [] }, { "oauth2": [ "seller-leads:read" ] } ], "x-casafari-operation-id": "seller-leads.list", "x-casafari-units": 100, "x-casafari-scope": "seller-leads:read", "parameters": [ { "name": "page_size", "in": "query", "required": false, "description": "Page size, at most 100 (a Free plan account is capped lower).", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "description": "Position of the next page, copied from the previous response.", "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "description": "ISO 3166-1 alpha-2 code of the point's country (ES, FR, IT, DE, GR or AD). Needed when the account covers several.", "schema": { "type": "string", "minLength": 2, "maxLength": 2 } }, { "name": "lat", "in": "query", "required": false, "description": "Latitude of the point to search around. Required unless cursor is sent.", "schema": { "type": "number", "minimum": -90, "maximum": 90 } }, { "name": "lon", "in": "query", "required": false, "description": "Longitude of the point to search around. Required unless cursor is sent.", "schema": { "type": "number", "minimum": -180, "maximum": 180 } }, { "name": "radius_m", "in": "query", "required": false, "description": "Radius in metres.", "schema": { "type": "integer", "minimum": 50, "maximum": 300, "default": 300 } }, { "name": "operation", "in": "query", "required": false, "description": "sale or rent.", "schema": { "type": "string", "enum": [ "sale", "rent" ], "default": "sale" } }, { "name": "min_price_cuts", "in": "query", "required": false, "description": "Fewest price cuts.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 1 } }, { "name": "min_price_cut_pct", "in": "query", "required": false, "description": "Smallest total cut, in percent.", "schema": { "type": "number", "minimum": 0.1, "maximum": 100, "default": 5 } }, { "name": "since", "in": "query", "required": false, "description": "YYYY-MM-DD: also count the cuts since this date (price_cuts_since).", "schema": { "type": "string", "format": "date" } }, { "name": "types", "in": "query", "required": false, "description": "Comma-separated property types, e.g. apartment,house.", "schema": { "type": "string" } }, { "name": "price_min", "in": "query", "required": false, "description": "Lowest asking price.", "schema": { "type": "integer", "minimum": 1 } }, { "name": "price_max", "in": "query", "required": false, "description": "Highest asking price.", "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "Success.", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" }, "Casafari-Units-Charged": { "$ref": "#/components/headers/Casafari-Units-Charged" }, "Casafari-Units-Remaining": { "$ref": "#/components/headers/Casafari-Units-Remaining" }, "Casafari-Units-Source": { "$ref": "#/components/headers/Casafari-Units-Source" }, "Casafari-Plan": { "$ref": "#/components/headers/Casafari-Plan" }, "RateLimit": { "$ref": "#/components/headers/RateLimit" }, "RateLimit-Policy": { "$ref": "#/components/headers/RateLimit-Policy" } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "`invalid_request`, `key_in_query`, `page_depth_exceeded` (https://platform.casafari.com/errors/invalid-request, https://platform.casafari.com/errors/key-in-query, https://platform.casafari.com/errors/page-depth-exceeded)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "invalid_request": { "value": { "type": "https://platform.casafari.com/errors/invalid-request", "title": "The request is not valid.", "status": 400, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "invalid_request", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "key_in_query": { "value": { "type": "https://platform.casafari.com/errors/key-in-query", "title": "Credentials are not accepted in the URL.", "status": 400, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "key_in_query", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "page_depth_exceeded": { "value": { "type": "https://platform.casafari.com/errors/page-depth-exceeded", "title": "The request asks for more results than this plan allows.", "status": 400, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "page_depth_exceeded", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "invalid_request", "key_in_query", "page_depth_exceeded" ] }, "401": { "description": "`unauthorized`, `invalid_credential`, `credential_revoked`, `token_expired` (https://platform.casafari.com/errors/unauthorized, https://platform.casafari.com/errors/invalid-credential, https://platform.casafari.com/errors/credential-revoked, https://platform.casafari.com/errors/token-expired)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "unauthorized": { "value": { "type": "https://platform.casafari.com/errors/unauthorized", "title": "A credential is required.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "unauthorized", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "invalid_credential": { "value": { "type": "https://platform.casafari.com/errors/invalid-credential", "title": "The credential is not valid.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "invalid_credential", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "credential_revoked": { "value": { "type": "https://platform.casafari.com/errors/credential-revoked", "title": "The credential has been revoked.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "credential_revoked", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "token_expired": { "value": { "type": "https://platform.casafari.com/errors/token-expired", "title": "The access token has expired.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "token_expired", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "unauthorized", "invalid_credential", "credential_revoked", "token_expired" ] }, "402": { "description": "`payment_required` (https://platform.casafari.com/errors/payment-required)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "payment_required": { "value": { "type": "https://platform.casafari.com/errors/payment-required", "title": "Payment is required to continue.", "status": 402, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "payment_required", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "payment_required" ] }, "403": { "description": "`insufficient_scope`, `not_entitled`, `account_suspended` (https://platform.casafari.com/errors/insufficient-scope, https://platform.casafari.com/errors/not-entitled, https://platform.casafari.com/errors/account-suspended)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "insufficient_scope": { "value": { "type": "https://platform.casafari.com/errors/insufficient-scope", "title": "The credential lacks the scope this operation needs.", "status": 403, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "insufficient_scope", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "not_entitled": { "value": { "type": "https://platform.casafari.com/errors/not-entitled", "title": "This account is not entitled to this product or country.", "status": 403, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "not_entitled", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "account_suspended": { "value": { "type": "https://platform.casafari.com/errors/account-suspended", "title": "The account is suspended.", "status": 403, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "account_suspended", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "insufficient_scope", "not_entitled", "account_suspended" ] }, "404": { "description": "`not_found` (https://platform.casafari.com/errors/not-found)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "not_found": { "value": { "type": "https://platform.casafari.com/errors/not-found", "title": "Not found.", "status": 404, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "not_found", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "not_found" ] }, "405": { "description": "`method_not_allowed` (https://platform.casafari.com/errors/method-not-allowed)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "method_not_allowed": { "value": { "type": "https://platform.casafari.com/errors/method-not-allowed", "title": "Method not allowed.", "status": 405, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "method_not_allowed", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "method_not_allowed" ] }, "429": { "description": "`rate_limited`, `daily_limit_reached`, `request_limit_reached`, `usage_limit_reached` (https://platform.casafari.com/errors/rate-limited, https://platform.casafari.com/errors/daily-limit-reached, https://platform.casafari.com/errors/request-limit-reached, https://platform.casafari.com/errors/usage-limit-reached)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "rate_limited": { "value": { "type": "https://platform.casafari.com/errors/rate-limited", "title": "Too many requests.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "rate_limited", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "daily_limit_reached": { "value": { "type": "https://platform.casafari.com/errors/daily-limit-reached", "title": "This account has reached its daily limit.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "daily_limit_reached", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "request_limit_reached": { "value": { "type": "https://platform.casafari.com/errors/request-limit-reached", "title": "This account has reached a request limit.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "request_limit_reached", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "usage_limit_reached": { "value": { "type": "https://platform.casafari.com/errors/usage-limit-reached", "title": "A usage limit of this plan is used up.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "usage_limit_reached", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "rate_limited", "daily_limit_reached", "request_limit_reached", "usage_limit_reached" ] }, "500": { "description": "`internal_error` (https://platform.casafari.com/errors/internal-error)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "internal_error": { "value": { "type": "https://platform.casafari.com/errors/internal-error", "title": "Something went wrong on our side.", "status": 500, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "internal_error", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "internal_error" ] }, "502": { "description": "`upstream_error` (https://platform.casafari.com/errors/upstream-error)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "upstream_error": { "value": { "type": "https://platform.casafari.com/errors/upstream-error", "title": "The data service failed to answer.", "status": 502, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "upstream_error", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "upstream_error" ] }, "503": { "description": "`capacity_exhausted`, `unavailable` (https://platform.casafari.com/errors/capacity-exhausted, https://platform.casafari.com/errors/unavailable)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "capacity_exhausted": { "value": { "type": "https://platform.casafari.com/errors/capacity-exhausted", "title": "The platform has reached its capacity for today.", "status": 503, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "capacity_exhausted", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "unavailable": { "value": { "type": "https://platform.casafari.com/errors/unavailable", "title": "The service is not available just now.", "status": 503, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "unavailable", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "capacity_exhausted", "unavailable" ] }, "504": { "description": "`upstream_timeout` (https://platform.casafari.com/errors/upstream-timeout)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "upstream_timeout": { "value": { "type": "https://platform.casafari.com/errors/upstream-timeout", "title": "The data service took too long to answer.", "status": 504, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads", "code": "upstream_timeout", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "upstream_timeout" ] } } } }, "/v1/seller-leads/{lead_id}": { "get": { "operationId": "seller_leads_get", "summary": "Seller leads get", "description": "Costs 10 tokens a call. One lead by its lead_ id, with its price-change history. The same property opens in Property Sourcing by the lead's property_id (GET /v1/property-sourcing/properties/{property_id}).", "tags": [ "High Potential Seller Leads" ], "security": [ { "apiKeyBearer": [] }, { "apiKeyHeader": [] }, { "oauth2": [ "seller-leads:read" ] } ], "x-casafari-operation-id": "seller-leads.get", "x-casafari-units": 10, "x-casafari-scope": "seller-leads:read", "parameters": [ { "name": "lead_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success.", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" }, "Casafari-Units-Charged": { "$ref": "#/components/headers/Casafari-Units-Charged" }, "Casafari-Units-Remaining": { "$ref": "#/components/headers/Casafari-Units-Remaining" }, "Casafari-Units-Source": { "$ref": "#/components/headers/Casafari-Units-Source" }, "Casafari-Plan": { "$ref": "#/components/headers/Casafari-Plan" }, "RateLimit": { "$ref": "#/components/headers/RateLimit" }, "RateLimit-Policy": { "$ref": "#/components/headers/RateLimit-Policy" } }, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "`invalid_request`, `key_in_query` (https://platform.casafari.com/errors/invalid-request, https://platform.casafari.com/errors/key-in-query)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "invalid_request": { "value": { "type": "https://platform.casafari.com/errors/invalid-request", "title": "The request is not valid.", "status": 400, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "invalid_request", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "key_in_query": { "value": { "type": "https://platform.casafari.com/errors/key-in-query", "title": "Credentials are not accepted in the URL.", "status": 400, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "key_in_query", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "invalid_request", "key_in_query" ] }, "401": { "description": "`unauthorized`, `invalid_credential`, `credential_revoked`, `token_expired` (https://platform.casafari.com/errors/unauthorized, https://platform.casafari.com/errors/invalid-credential, https://platform.casafari.com/errors/credential-revoked, https://platform.casafari.com/errors/token-expired)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "unauthorized": { "value": { "type": "https://platform.casafari.com/errors/unauthorized", "title": "A credential is required.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "unauthorized", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "invalid_credential": { "value": { "type": "https://platform.casafari.com/errors/invalid-credential", "title": "The credential is not valid.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "invalid_credential", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "credential_revoked": { "value": { "type": "https://platform.casafari.com/errors/credential-revoked", "title": "The credential has been revoked.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "credential_revoked", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "token_expired": { "value": { "type": "https://platform.casafari.com/errors/token-expired", "title": "The access token has expired.", "status": 401, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "token_expired", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "unauthorized", "invalid_credential", "credential_revoked", "token_expired" ] }, "402": { "description": "`payment_required` (https://platform.casafari.com/errors/payment-required)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "payment_required": { "value": { "type": "https://platform.casafari.com/errors/payment-required", "title": "Payment is required to continue.", "status": 402, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "payment_required", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "payment_required" ] }, "403": { "description": "`insufficient_scope`, `not_entitled`, `account_suspended` (https://platform.casafari.com/errors/insufficient-scope, https://platform.casafari.com/errors/not-entitled, https://platform.casafari.com/errors/account-suspended)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "insufficient_scope": { "value": { "type": "https://platform.casafari.com/errors/insufficient-scope", "title": "The credential lacks the scope this operation needs.", "status": 403, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "insufficient_scope", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "not_entitled": { "value": { "type": "https://platform.casafari.com/errors/not-entitled", "title": "This account is not entitled to this product or country.", "status": 403, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "not_entitled", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "account_suspended": { "value": { "type": "https://platform.casafari.com/errors/account-suspended", "title": "The account is suspended.", "status": 403, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "account_suspended", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "insufficient_scope", "not_entitled", "account_suspended" ] }, "404": { "description": "`not_found` (https://platform.casafari.com/errors/not-found)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "not_found": { "value": { "type": "https://platform.casafari.com/errors/not-found", "title": "Not found.", "status": 404, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "not_found", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "not_found" ] }, "405": { "description": "`method_not_allowed` (https://platform.casafari.com/errors/method-not-allowed)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "method_not_allowed": { "value": { "type": "https://platform.casafari.com/errors/method-not-allowed", "title": "Method not allowed.", "status": 405, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "method_not_allowed", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "method_not_allowed" ] }, "429": { "description": "`rate_limited`, `daily_limit_reached`, `request_limit_reached`, `usage_limit_reached` (https://platform.casafari.com/errors/rate-limited, https://platform.casafari.com/errors/daily-limit-reached, https://platform.casafari.com/errors/request-limit-reached, https://platform.casafari.com/errors/usage-limit-reached)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "rate_limited": { "value": { "type": "https://platform.casafari.com/errors/rate-limited", "title": "Too many requests.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "rate_limited", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "daily_limit_reached": { "value": { "type": "https://platform.casafari.com/errors/daily-limit-reached", "title": "This account has reached its daily limit.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "daily_limit_reached", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "request_limit_reached": { "value": { "type": "https://platform.casafari.com/errors/request-limit-reached", "title": "This account has reached a request limit.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "request_limit_reached", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "usage_limit_reached": { "value": { "type": "https://platform.casafari.com/errors/usage-limit-reached", "title": "A usage limit of this plan is used up.", "status": 429, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "usage_limit_reached", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "rate_limited", "daily_limit_reached", "request_limit_reached", "usage_limit_reached" ] }, "500": { "description": "`internal_error` (https://platform.casafari.com/errors/internal-error)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "internal_error": { "value": { "type": "https://platform.casafari.com/errors/internal-error", "title": "Something went wrong on our side.", "status": 500, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "internal_error", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "internal_error" ] }, "502": { "description": "`upstream_error` (https://platform.casafari.com/errors/upstream-error)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "upstream_error": { "value": { "type": "https://platform.casafari.com/errors/upstream-error", "title": "The data service failed to answer.", "status": 502, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "upstream_error", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "upstream_error" ] }, "503": { "description": "`capacity_exhausted`, `unavailable` (https://platform.casafari.com/errors/capacity-exhausted, https://platform.casafari.com/errors/unavailable)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "capacity_exhausted": { "value": { "type": "https://platform.casafari.com/errors/capacity-exhausted", "title": "The platform has reached its capacity for today.", "status": 503, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "capacity_exhausted", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } }, "unavailable": { "value": { "type": "https://platform.casafari.com/errors/unavailable", "title": "The service is not available just now.", "status": 503, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "unavailable", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "capacity_exhausted", "unavailable" ] }, "504": { "description": "`upstream_timeout` (https://platform.casafari.com/errors/upstream-timeout)", "headers": { "Casafari-Request-Id": { "$ref": "#/components/headers/Casafari-Request-Id" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "examples": { "upstream_timeout": { "value": { "type": "https://platform.casafari.com/errors/upstream-timeout", "title": "The data service took too long to answer.", "status": 504, "detail": "Written for the request; see the code's page.", "instance": "/v1/seller-leads/{lead_id}", "code": "upstream_timeout", "request_id": "req_01JABCDEFGHJKMNPQRSTVWXYZ2" } } } } }, "x-casafari-codes": [ "upstream_timeout" ] } } } } }, "components": { "schemas": { "Problem": { "type": "object", "required": [ "type", "title", "status", "detail", "instance", "code", "request_id" ], "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "code": { "type": "string", "enum": [ "invalid_request", "validation_failed", "key_in_query", "page_depth_exceeded", "payload_too_large", "unsupported_media_type", "unauthorized", "invalid_credential", "credential_revoked", "token_expired", "insufficient_scope", "not_entitled", "verification_required", "not_self_serve", "account_suspended", "permission_denied", "origin_mismatch", "reauthentication_required", "payment_required", "not_found", "existing_api_path", "method_not_allowed", "conflict", "resource_limit_reached", "rate_limited", "daily_limit_reached", "request_limit_reached", "signup_limited", "email_not_allowed", "terms_not_accepted", "verification_code_invalid", "verification_code_expired", "internal_error", "upstream_error", "capacity_exhausted", "unavailable", "upstream_timeout", "usage_limit_reached" ] }, "request_id": { "type": "string" } }, "additionalProperties": true }, "AccountStatus": { "type": "object", "required": [ "account_id", "plan", "standing", "can_call", "units" ], "properties": { "account_id": { "type": "string" }, "name": { "type": "string" }, "plan": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "billing_mode": { "type": "string" } } }, "standing": { "type": "string" }, "can_call": { "type": "boolean" }, "blocked_reason": { "type": [ "string", "null" ] }, "reset_at": { "type": [ "string", "null" ], "format": "date-time" }, "request_limits": { "type": "array", "items": { "type": "object", "required": [ "window", "unit", "limit", "used", "remaining", "period_seconds", "reset_at" ], "properties": { "window": { "type": "string", "enum": [ "minute", "session", "day", "week", "month", "locations" ] }, "unit": { "type": "string", "enum": [ "requests", "places" ] }, "limit": { "type": "integer" }, "used": { "type": "integer" }, "remaining": { "type": "integer" }, "period_seconds": { "type": "integer" }, "reset_at": { "type": "string", "format": "date-time" } } } }, "claro_trial_searches": { "type": [ "object", "null" ], "required": [ "limit", "used", "remaining" ], "properties": { "limit": { "type": "integer" }, "used": { "type": "integer" }, "remaining": { "type": "integer" } } }, "units": { "type": "object", "additionalProperties": true }, "upgrade_url": { "type": [ "string", "null" ], "format": "uri" }, "console_url": { "type": "string", "format": "uri" } }, "additionalProperties": true }, "PaymentLinkStatus": { "type": "object", "required": [ "payment_link_id", "status", "poll_after_s" ], "properties": { "payment_link_id": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "completed", "expired", "superseded" ] }, "reason": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" }, "expires_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": [ "string", "null" ], "format": "date-time" }, "poll_after_s": { "type": "integer" } } }, "SignupRequest": { "type": "object", "required": [ "email", "terms_version" ], "properties": { "email": { "type": "string", "format": "email" }, "terms_version": { "type": "string" }, "account_name": { "type": "string" }, "client": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri" } } }, "tips_opt_out": { "type": "boolean", "default": false, "description": "true: don't send the person tips and usage emails. Account, billing and security emails still arrive." }, "news_opt_in": { "type": "boolean", "default": false, "description": "true: the person agrees to news emails." } } }, "SignupStarted": { "type": "object", "required": [ "signup_id", "status", "verify_url" ], "properties": { "signup_id": { "type": "string" }, "status": { "const": "code_sent" }, "delivery": { "const": "email" }, "expires_at": { "type": "string", "format": "date-time" }, "verify_url": { "type": "string", "format": "uri" }, "terms_url": { "type": "string", "format": "uri" } } }, "SignupVerifyRequest": { "type": "object", "required": [ "code" ], "properties": { "code": { "type": "string", "description": "The 6-digit code emailed to the person." } } }, "SignupCompleted": { "type": "object", "required": [ "account_id", "api_key", "scopes", "plan" ], "properties": { "account_id": { "type": "string" }, "user_id": { "type": "string" }, "api_key": { "type": "string", "description": "Shown once." }, "key_id": { "type": "string" }, "key_hint": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string" } }, "plan": { "type": "object", "properties": { "id": { "type": "string" }, "trial_units": { "type": [ "integer", "null" ] }, "trial_ends_at": { "type": [ "string", "null" ], "format": "date-time" } } }, "api_base_url": { "type": "string", "format": "uri" }, "resources": { "type": "object", "additionalProperties": true }, "console_url": { "type": "string", "format": "uri" }, "docs_url": { "type": "string", "format": "uri" } } }, "SignupTerms": { "type": "object", "required": [ "terms_version", "terms_url", "privacy_url" ], "properties": { "terms_version": { "type": "string" }, "terms_url": { "type": "string", "format": "uri" }, "privacy_url": { "type": "string", "format": "uri" } } } }, "headers": { "Casafari-Request-Id": { "description": "Id of this request; quote it when asking for help.", "schema": { "type": "string" } }, "Casafari-Units-Charged": { "description": "Tokens this call cost.", "schema": { "type": "integer" } }, "Casafari-Units-Remaining": { "description": "Tokens left across the account's funding.", "schema": { "type": "integer" } }, "Casafari-Units-Source": { "description": "Which funding paid: trial, included, prepaid or overage.", "schema": { "type": "string" } }, "Casafari-Plan": { "description": "The account's plan id.", "schema": { "type": "string" } }, "RateLimit": { "description": "Current rate-limit state (RFC 9331 draft).", "schema": { "type": "string" } }, "RateLimit-Policy": { "description": "The rate-limit policy that applies.", "schema": { "type": "string" } } }, "securitySchemes": { "apiKeyBearer": { "type": "http", "scheme": "bearer", "bearerFormat": "cf_sk_ API key", "description": "Authorization: Bearer cf_sk_..." }, "apiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "The same API key in a header." }, "oauth2": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "https://platform.casafari.com/oauth/authorize", "tokenUrl": "https://platform.casafari.com/oauth/token", "scopes": { "account:read": "Access to account (read).", "locations:read": "Access to locations (read).", "seller-leads:read": "Access to seller-leads (read)." } }, "clientCredentials": { "tokenUrl": "https://platform.casafari.com/oauth/token", "scopes": { "account:read": "Access to account (read).", "locations:read": "Access to locations (read).", "seller-leads:read": "Access to seller-leads (read)." } } } } } }, "x-casafari-resource": "https://platform.casafari.com/v1/seller-leads" }