{
  "openapi": "3.1.0",
  "info": {
    "title": "Veysa API",
    "version": "1.0",
    "description": "Read-only access to your Veysa workspace: company and contact search, company\nrecords, saved lists and signals, and your usage.\n\n**Authentication.** Send an API key from Settings > API keys as\n`Authorization: Bearer <key>`. API access is included with the Team and Agency\nplans. A key can call only the endpoints documented here; any other route\nanswers `403` with `code: api_key_endpoint_not_allowed`.\n\n**Monthly quota.** Team includes 5,000 calls a month and Agency 15,000,\nshared by every key in the workspace. The count resets on the 1st of each\nmonth (UTC). Every response carries `X-Quota-Limit`, `X-Quota-Remaining` and\n`X-Quota-Reset` (Unix seconds). Over the limit the API answers `429` with\n`code: api_quota_exceeded` and a `Retry-After` header.\n\n**Rate limit.** Bursts are also limited per minute; a `429` from the burst\nlimit carries `Retry-After` too.\n\nThe API is read-only: it never runs a new reveal or spends enrichment credits.\nContact emails and phones appear only where your workspace already revealed\nthem in the app.\nWebhooks are not available yet.\n"
  },
  "servers": [
    {
      "url": "https://api.veysa.ae"
    }
  ],
  "paths": {
    "/v1/companies/{company_id}": {
      "get": {
        "tags": [
          "companies"
        ],
        "summary": "Get a company",
        "operationId": "get_company_v1_companies__company_id__get",
        "parameters": [
          {
            "name": "company_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Company Id"
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^(en|ar)$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Briefing language: en or ar",
              "title": "Language"
            },
            "description": "Briefing language: en or ar"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Get Company V1 Companies  Company Id  Get"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "One company record with its sources."
      }
    },
    "/v1/companies/{company_id}/contacts": {
      "get": {
        "tags": [
          "companies"
        ],
        "summary": "List a company's contacts",
        "operationId": "get_company_contacts_v1_companies__company_id__contacts_get",
        "parameters": [
          {
            "name": "company_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Company Id"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 25,
              "title": "Per Page"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Get Company Contacts V1 Companies  Company Id  Contacts Get"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Contacts at one company."
      }
    },
    "/v1/companies/{company_id}/signals": {
      "get": {
        "tags": [
          "companies"
        ],
        "summary": "List a company's signals",
        "description": "Dated buying signals for one company.",
        "operationId": "get_company_signals_v1_companies__company_id__signals_get",
        "parameters": [
          {
            "name": "company_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Company Id"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 25,
              "title": "Per Page"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanySignalsResponse"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    },
    "/v1/contacts/{contact_id}": {
      "get": {
        "tags": [
          "contacts"
        ],
        "summary": "Get a contact",
        "operationId": "get_contact_v1_contacts__contact_id__get",
        "parameters": [
          {
            "name": "contact_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "title": "Contact Id"
            }
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^(en|ar)$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Briefing language: en or ar",
              "title": "Language"
            },
            "description": "Briefing language: en or ar"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true,
                  "title": "Response Get Contact V1 Contacts  Contact Id  Get"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "One contact. Email and phone appear only if your workspace already revealed them."
      }
    },
    "/v1/lists": {
      "get": {
        "tags": [
          "lists"
        ],
        "summary": "List saved lists",
        "operationId": "list_lists_v1_lists_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ListSummary"
                  },
                  "type": "array",
                  "title": "Response List Lists V1 Lists Get"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Your workspace's saved lists."
      }
    },
    "/v1/lists/{list_id}": {
      "get": {
        "tags": [
          "lists"
        ],
        "summary": "Get a list",
        "operationId": "get_list_v1_lists__list_id__get",
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "List Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListDetail"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "One saved list."
      }
    },
    "/v1/lists/{list_id}/items": {
      "get": {
        "tags": [
          "lists"
        ],
        "summary": "List the items in a list",
        "operationId": "get_list_items_v1_lists__list_id__items_get",
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "List Id"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 25,
              "title": "Per Page"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListItemsResponse"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Companies or contacts saved to a list."
      }
    },
    "/v1/search/companies": {
      "get": {
        "tags": [
          "search"
        ],
        "summary": "Search companies",
        "operationId": "search_companies_v1_search_companies_get",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 500
                },
                {
                  "type": "null"
                }
              ],
              "description": "Full-text search query",
              "title": "Q"
            },
            "description": "Full-text search query"
          },
          {
            "name": "industry",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Industry filter (comma-separated for multiple)",
              "title": "Industry"
            },
            "description": "Industry filter (comma-separated for multiple)"
          },
          {
            "name": "sub_industry",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Sub Industry"
            }
          },
          {
            "name": "employee_min",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Employee Min"
            }
          },
          {
            "name": "employee_max",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Employee Max"
            }
          },
          {
            "name": "employee_range",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Employee count band (e.g. '11-50')",
              "title": "Employee Range"
            },
            "description": "Employee count band (e.g. '11-50')"
          },
          {
            "name": "hq_country",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "ISO 3166-1 alpha-2 country code",
              "title": "Hq Country"
            },
            "description": "ISO 3166-1 alpha-2 country code"
          },
          {
            "name": "hq_city",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Hq City"
            }
          },
          {
            "name": "legal_form",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Legal Form"
            }
          },
          {
            "name": "employee_count_band",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Employee Count Band"
            }
          },
          {
            "name": "tech_stack",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Comma-separated tech tags (array containment)",
              "title": "Tech Stack"
            },
            "description": "Comma-separated tech tags (array containment)"
          },
          {
            "name": "funding_stage",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Funding Stage"
            }
          },
          {
            "name": "revenue_band",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Revenue Band"
            }
          },
          {
            "name": "registered_capital_min",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "number",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Registered Capital Min"
            }
          },
          {
            "name": "registered_capital_max",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "number",
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Registered Capital Max"
            }
          },
          {
            "name": "founded_year_min",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "maximum": 2200,
                  "minimum": 1800
                },
                {
                  "type": "null"
                }
              ],
              "title": "Founded Year Min"
            }
          },
          {
            "name": "founded_year_max",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "maximum": 2200,
                  "minimum": 1800
                },
                {
                  "type": "null"
                }
              ],
              "title": "Founded Year Max"
            }
          },
          {
            "name": "min_completeness_pct",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "integer",
                  "maximum": 100,
                  "minimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "title": "Min Completeness Pct"
            }
          },
          {
            "name": "actionability_tier",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Actionability Tier"
            }
          },
          {
            "name": "has_description",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Has Description"
            }
          },
          {
            "name": "has_funding_signal",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company has a funding signal in last 90 days",
              "title": "Has Funding Signal"
            },
            "description": "Company has a funding signal in last 90 days"
          },
          {
            "name": "has_hiring_signal",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company has a hiring signal in last 90 days",
              "title": "Has Hiring Signal"
            },
            "description": "Company has a hiring signal in last 90 days"
          },
          {
            "name": "has_leadership_change",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company has a leadership_change signal in last 90 days",
              "title": "Has Leadership Change"
            },
            "description": "Company has a leadership_change signal in last 90 days"
          },
          {
            "name": "has_expansion_signal",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company has an expansion signal in last 90 days",
              "title": "Has Expansion Signal"
            },
            "description": "Company has an expansion signal in last 90 days"
          },
          {
            "name": "has_renewal_due",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Trade license renewal due within 90 days (live registry signal)",
              "title": "Has Renewal Due"
            },
            "description": "Trade license renewal due within 90 days (live registry signal)"
          },
          {
            "name": "has_newly_licensed",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Licensed within the last 12 months (live registry signal)",
              "title": "Has Newly Licensed"
            },
            "description": "Licensed within the last 12 months (live registry signal)"
          },
          {
            "name": "license_category",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Commercial|Professional|Industrial|Tourism",
              "title": "License Category"
            },
            "description": "Commercial|Professional|Industrial|Tourism"
          },
          {
            "name": "license_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Active|Cancelled|Frozen etc. No default — UI controls.",
              "title": "License Status"
            },
            "description": "Active|Cancelled|Frozen etc. No default — UI controls."
          },
          {
            "name": "license_authority",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Licensing authority or free zone (e.g. DMCC, ADGM)",
              "title": "License Authority"
            },
            "description": "Licensing authority or free zone (e.g. DMCC, ADGM)"
          },
          {
            "name": "emirate",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Normalised UAE emirate (Dubai, Abu Dhabi, ...)",
              "title": "Emirate"
            },
            "description": "Normalised UAE emirate (Dubai, Abu Dhabi, ...)"
          },
          {
            "name": "free_zone",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "true|false or a named free zone / authority",
              "title": "Free Zone"
            },
            "description": "true|false or a named free zone / authority"
          },
          {
            "name": "isic",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "ISIC 4 codes or prefixes, comma separated (e.g. 5222 or 52)",
              "title": "Isic"
            },
            "description": "ISIC 4 codes or prefixes, comma separated (e.g. 5222 or 52)"
          },
          {
            "name": "activity",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "DED activity code, or text in the activity label (English or Arabic)",
              "title": "Activity"
            },
            "description": "DED activity code, or text in the activity label (English or Arabic)"
          },
          {
            "name": "has_dp_link",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company is matched to Dubai government registry records",
              "title": "Has Dp Link"
            },
            "description": "Company is matched to Dubai government registry records"
          },
          {
            "name": "has_active_project",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company is contractor or consultant on a project that is still active",
              "title": "Has Active Project"
            },
            "description": "Company is contractor or consultant on a project that is still active"
          },
          {
            "name": "project_role",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "contractor|consultant, comma separated: a role on a Dubai Municipality project",
              "title": "Project Role"
            },
            "description": "contractor|consultant, comma separated: a role on a Dubai Municipality project"
          },
          {
            "name": "has_fnb_outlet",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company has a licensed food and beverage outlet",
              "title": "Has Fnb Outlet"
            },
            "description": "Company has a licensed food and beverage outlet"
          },
          {
            "name": "deq_permit_status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Engineering practice permit: active|expired|suspended|cancelled|any, comma separated",
              "title": "Deq Permit Status"
            },
            "description": "Engineering practice permit: active|expired|suspended|cancelled|any, comma separated"
          },
          {
            "name": "listed",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Company is a Dubai Financial Market listed security",
              "title": "Listed"
            },
            "description": "Company is a Dubai Financial Market listed security"
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "fit|relevance|employee_count|name|data_quality",
              "default": "fit",
              "title": "Sort By"
            },
            "description": "fit|relevance|employee_count|name|data_quality"
          },
          {
            "name": "include_fit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Score and rank rows against the active ICP when one exists",
              "default": true,
              "title": "Include Fit"
            },
            "description": "Score and rank rows against the active ICP when one exists"
          },
          {
            "name": "show_poor_fit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "When an ICP is scoring, include Poor-fit rows (hidden by default)",
              "default": false,
              "title": "Show Poor Fit"
            },
            "description": "When an ICP is scoring, include Poor-fit rows (hidden by default)"
          },
          {
            "name": "icp_segment",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 8000
                },
                {
                  "type": "null"
                }
              ],
              "description": "JSON ICP segment to browse exactly",
              "title": "Icp Segment"
            },
            "description": "JSON ICP segment to browse exactly"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 25,
              "title": "Per Page"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanySearchResponse"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Filter and page through UAE companies."
      }
    },
    "/v1/search/contacts": {
      "get": {
        "tags": [
          "search"
        ],
        "summary": "Search contacts",
        "operationId": "search_contacts_v1_search_contacts_get",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Full-text search on name + title",
              "title": "Q"
            },
            "description": "Full-text search on name + title"
          },
          {
            "name": "company_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter to one company",
              "title": "Company Id"
            },
            "description": "Filter to one company"
          },
          {
            "name": "seniority_level",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "c_suite|vp|director|manager|senior|mid|junior",
              "title": "Seniority Level"
            },
            "description": "c_suite|vp|director|manager|senior|mid|junior"
          },
          {
            "name": "department",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Department"
            }
          },
          {
            "name": "location_country",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Location Country"
            }
          },
          {
            "name": "hq_country",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Alias for location_country (used by unified search)",
              "title": "Hq Country"
            },
            "description": "Alias for location_country (used by unified search)"
          },
          {
            "name": "has_verified_email",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Has Verified Email"
            }
          },
          {
            "name": "has_verified_phone",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Has Verified Phone"
            }
          },
          {
            "name": "has_phone",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Alias for has_verified_phone",
              "title": "Has Phone"
            },
            "description": "Alias for has_verified_phone"
          },
          {
            "name": "sort_by",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "description": "fit|relevance|seniority|name|confidence",
              "default": "fit",
              "title": "Sort By"
            },
            "description": "fit|relevance|seniority|name|confidence"
          },
          {
            "name": "include_fit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Score each contact by their company's fit to the active ICP",
              "default": true,
              "title": "Include Fit"
            },
            "description": "Score each contact by their company's fit to the active ICP"
          },
          {
            "name": "show_poor_fit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "When an ICP is scoring, include Poor-fit companies (hidden by default)",
              "default": false,
              "title": "Show Poor Fit"
            },
            "description": "When an ICP is scoring, include Poor-fit companies (hidden by default)"
          },
          {
            "name": "icp_segment",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 8000
                },
                {
                  "type": "null"
                }
              ],
              "description": "JSON ICP segment to browse exactly",
              "title": "Icp Segment"
            },
            "description": "JSON ICP segment to browse exactly"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1,
              "title": "Page"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 25,
              "title": "Per Page"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContactSearchResponse"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Filter and page through contacts. Paid channels stay masked."
      }
    },
    "/v1/signals": {
      "get": {
        "tags": [
          "signals"
        ],
        "summary": "Signal feed",
        "description": "Ranked insight feed: one card per company, best signal first.",
        "operationId": "get_brief_v1_signals_get",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 20,
              "title": "Limit"
            }
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "all",
                "accounts"
              ],
              "type": "string",
              "default": "all",
              "title": "Scope"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BriefResponse"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    },
    "/v1/usage": {
      "get": {
        "tags": [
          "usage"
        ],
        "summary": "Get usage",
        "operationId": "get_usage_v1_usage_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response Get Usage V1 Usage Get"
                }
              }
            },
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key."
          },
          "403": {
            "description": "The workspace's plan does not include API access."
          },
          "429": {
            "description": "Monthly API quota used up (code api_quota_exceeded) or burst limit hit.",
            "headers": {
              "X-Quota-Limit": {
                "description": "API calls included this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Remaining": {
                "description": "API calls left this month.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-Quota-Reset": {
                "description": "When the monthly count resets, in Unix seconds (UTC).",
                "schema": {
                  "type": "integer"
                }
              },
              "Retry-After": {
                "description": "Seconds to wait.",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Credits, plan and this month's API calls for the workspace."
      }
    }
  },
  "components": {
    "schemas": {
      "BriefCompany": {
        "properties": {
          "legal_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Legal Name"
          },
          "industry": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Industry"
          },
          "hq_city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hq City"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain"
          }
        },
        "type": "object",
        "title": "BriefCompany"
      },
      "BriefInsight": {
        "properties": {
          "signal_id": {
            "type": "integer",
            "title": "Signal Id"
          },
          "canonical_id": {
            "type": "string",
            "title": "Canonical Id"
          },
          "signal_type": {
            "type": "string",
            "title": "Signal Type"
          },
          "headline": {
            "type": "string",
            "title": "Headline"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          },
          "why_now": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why Now"
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Url"
          },
          "source_record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Record"
          },
          "dataset": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dataset"
          },
          "record_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record Key"
          },
          "catalogue_no": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Catalogue No"
          },
          "data_license": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data License"
          },
          "event_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Date"
          },
          "on_account": {
            "type": "boolean",
            "title": "On Account",
            "default": false
          },
          "sources": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Sources"
          },
          "confidence": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Confidence"
          },
          "surfaced_at": {
            "type": "string",
            "title": "Surfaced At"
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "company": {
            "$ref": "#/components/schemas/BriefCompany"
          },
          "fit_score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Score"
          },
          "fit_segment_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Segment Name"
          },
          "fit_tier": {
            "type": "string",
            "title": "Fit Tier"
          },
          "score": {
            "type": "number",
            "title": "Score"
          }
        },
        "type": "object",
        "required": [
          "signal_id",
          "canonical_id",
          "signal_type",
          "headline",
          "surfaced_at",
          "company",
          "fit_tier",
          "score"
        ],
        "title": "BriefInsight"
      },
      "BriefResponse": {
        "properties": {
          "insights": {
            "items": {
              "$ref": "#/components/schemas/BriefInsight"
            },
            "type": "array",
            "title": "Insights"
          },
          "count": {
            "type": "integer",
            "title": "Count",
            "default": 0
          },
          "icp_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icp Id"
          },
          "icp_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icp Name"
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          }
        },
        "type": "object",
        "title": "BriefResponse"
      },
      "CompanySearchResponse": {
        "properties": {
          "results": {
            "items": {
              "$ref": "#/components/schemas/CompanySearchResult"
            },
            "type": "array",
            "title": "Results"
          },
          "total": {
            "type": "integer",
            "title": "Total"
          },
          "page": {
            "type": "integer",
            "title": "Page"
          },
          "per_page": {
            "type": "integer",
            "title": "Per Page"
          },
          "query_time_ms": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Query Time Ms"
          }
        },
        "type": "object",
        "required": [
          "results",
          "total",
          "page",
          "per_page"
        ],
        "title": "CompanySearchResponse"
      },
      "CompanySearchResult": {
        "properties": {
          "canonical_id": {
            "type": "string",
            "format": "uuid",
            "title": "Canonical Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain"
          },
          "industry": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Industry"
          },
          "employee_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Employee Count"
          },
          "employee_count_band": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Employee Count Band"
          },
          "hq_country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hq Country"
          },
          "hq_city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hq City"
          },
          "description_snippet": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description Snippet"
          },
          "tech_stack": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tech Stack"
          },
          "funding_stage": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Funding Stage"
          },
          "data_quality_grade": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Quality Grade"
          },
          "source_count": {
            "type": "integer",
            "title": "Source Count",
            "default": 0
          },
          "lifecycle_state": {
            "type": "string",
            "title": "Lifecycle State",
            "default": "DISCOVERED"
          },
          "last_enriched_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Enriched At"
          },
          "legal_form": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Legal Form"
          },
          "license_category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "License Category"
          },
          "license_status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "License Status"
          },
          "primary_activity": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Primary Activity"
          },
          "registered_capital": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Registered Capital"
          },
          "partner_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Partner Count"
          },
          "quality": {
            "$ref": "#/components/schemas/DataQuality"
          },
          "fit_score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Score"
          },
          "fit_tier": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Tier"
          },
          "fit_segment_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Segment Name"
          },
          "fit_segment_index": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Segment Index"
          },
          "name_local": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name Local"
          }
        },
        "type": "object",
        "required": [
          "canonical_id",
          "name"
        ],
        "title": "CompanySearchResult"
      },
      "CompanySignal": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "signal_type": {
            "type": "string",
            "title": "Signal Type"
          },
          "catalogue_no": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Catalogue No"
          },
          "headline": {
            "type": "string",
            "title": "Headline"
          },
          "event_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Event Date"
          },
          "observed_on": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Observed On"
          },
          "dataset": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dataset"
          },
          "record_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record Key"
          },
          "source_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Url"
          },
          "source_record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Record"
          },
          "data_license": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data License"
          },
          "confidence": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Confidence"
          },
          "match_method": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Match Method"
          },
          "market_level": {
            "type": "boolean",
            "title": "Market Level",
            "default": false
          },
          "evidence": {
            "additionalProperties": true,
            "type": "object",
            "title": "Evidence"
          },
          "sources": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Sources"
          },
          "surfaced_at": {
            "type": "string",
            "title": "Surfaced At"
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "detail": {
            "additionalProperties": true,
            "type": "object",
            "title": "Detail"
          }
        },
        "type": "object",
        "required": [
          "id",
          "signal_type",
          "headline",
          "surfaced_at"
        ],
        "title": "CompanySignal"
      },
      "CompanySignalsResponse": {
        "properties": {
          "results": {
            "items": {
              "$ref": "#/components/schemas/CompanySignal"
            },
            "type": "array",
            "title": "Results"
          },
          "page": {
            "type": "integer",
            "title": "Page"
          },
          "per_page": {
            "type": "integer",
            "title": "Per Page"
          }
        },
        "type": "object",
        "required": [
          "page",
          "per_page"
        ],
        "title": "CompanySignalsResponse"
      },
      "ContactSearchResponse": {
        "properties": {
          "results": {
            "items": {
              "$ref": "#/components/schemas/ContactSearchResult"
            },
            "type": "array",
            "title": "Results"
          },
          "total": {
            "type": "integer",
            "title": "Total"
          },
          "page": {
            "type": "integer",
            "title": "Page"
          },
          "per_page": {
            "type": "integer",
            "title": "Per Page"
          },
          "query_time_ms": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Query Time Ms"
          }
        },
        "type": "object",
        "required": [
          "results",
          "total",
          "page",
          "per_page"
        ],
        "title": "ContactSearchResponse"
      },
      "ContactSearchResult": {
        "properties": {
          "contact_id": {
            "type": "string",
            "format": "uuid",
            "title": "Contact Id"
          },
          "first_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "First Name"
          },
          "last_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Name"
          },
          "full_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Full Name"
          },
          "job_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Job Title"
          },
          "normalised_job_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Normalised Job Title"
          },
          "seniority_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Seniority Level"
          },
          "department": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Department"
          },
          "company_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company Name"
          },
          "company_domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company Domain"
          },
          "canonical_company_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Canonical Company Id"
          },
          "email_status": {
            "type": "string",
            "title": "Email Status",
            "default": "UNVERIFIED"
          },
          "email_confidence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email Confidence"
          },
          "phone_status": {
            "type": "string",
            "title": "Phone Status",
            "default": "UNVERIFIED"
          },
          "phone_confidence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Phone Confidence"
          },
          "location_country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location Country"
          },
          "location_city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location City"
          },
          "time_in_role_months": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Time In Role Months"
          },
          "quality": {
            "$ref": "#/components/schemas/DataQuality"
          },
          "fit_score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Score"
          },
          "fit_tier": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Tier"
          },
          "fit_segment_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Segment Name"
          },
          "fit_segment_index": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fit Segment Index"
          }
        },
        "type": "object",
        "required": [
          "contact_id"
        ],
        "title": "ContactSearchResult"
      },
      "DataQuality": {
        "properties": {
          "completeness_pct": {
            "type": "integer",
            "title": "Completeness Pct",
            "default": 0
          },
          "actionability_tier": {
            "type": "string",
            "title": "Actionability Tier",
            "default": "none"
          }
        },
        "type": "object",
        "title": "DataQuality",
        "description": "Two-dimensional quality signal for UI display."
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "ItemFields": {
        "properties": {
          "email": {
            "type": "string",
            "title": "Email"
          },
          "phone": {
            "type": "string",
            "title": "Phone"
          },
          "reveal": {
            "type": "string",
            "title": "Reveal"
          },
          "credits": {
            "type": "integer",
            "title": "Credits"
          }
        },
        "type": "object",
        "required": [
          "email",
          "phone",
          "reveal",
          "credits"
        ],
        "title": "ItemFields",
        "description": "What the shared store says about a contact's channels, and what this workspace paid for them."
      },
      "ListDetail": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "source": {
            "type": "string",
            "title": "Source"
          },
          "item_type": {
            "type": "string",
            "title": "Item Type"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags"
          },
          "total_items": {
            "type": "integer",
            "title": "Total Items"
          },
          "enriched_items": {
            "type": "integer",
            "title": "Enriched Items"
          },
          "verified_items": {
            "type": "integer",
            "title": "Verified Items"
          },
          "created_at": {
            "type": "string",
            "title": "Created At"
          },
          "updated_at": {
            "type": "string",
            "title": "Updated At"
          },
          "search_query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Search Query"
          },
          "filters": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Filters"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "source",
          "item_type",
          "tags",
          "total_items",
          "enriched_items",
          "verified_items",
          "created_at",
          "updated_at"
        ],
        "title": "ListDetail"
      },
      "ListItemRow": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "entity_type": {
            "type": "string",
            "title": "Entity Type"
          },
          "entity_id": {
            "type": "string",
            "title": "Entity Id"
          },
          "enrichment_status": {
            "type": "string",
            "title": "Enrichment Status"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "subtitle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subtitle"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain"
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "email_confidence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email Confidence"
          },
          "data_quality_grade": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Quality Grade"
          },
          "fields": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ItemFields"
              },
              {
                "type": "null"
              }
            ]
          },
          "columns": {
            "anyOf": [
              {
                "additionalProperties": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Columns"
          },
          "added_at": {
            "type": "string",
            "title": "Added At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "entity_type",
          "entity_id",
          "enrichment_status",
          "added_at"
        ],
        "title": "ListItemRow"
      },
      "ListItemsResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ListItemRow"
            },
            "type": "array",
            "title": "Items"
          },
          "total": {
            "type": "integer",
            "title": "Total"
          },
          "page": {
            "type": "integer",
            "title": "Page"
          },
          "per_page": {
            "type": "integer",
            "title": "Per Page"
          }
        },
        "type": "object",
        "required": [
          "items",
          "total",
          "page",
          "per_page"
        ],
        "title": "ListItemsResponse"
      },
      "ListSummary": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "source": {
            "type": "string",
            "title": "Source"
          },
          "item_type": {
            "type": "string",
            "title": "Item Type"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tags"
          },
          "total_items": {
            "type": "integer",
            "title": "Total Items"
          },
          "enriched_items": {
            "type": "integer",
            "title": "Enriched Items"
          },
          "verified_items": {
            "type": "integer",
            "title": "Verified Items"
          },
          "created_at": {
            "type": "string",
            "title": "Created At"
          },
          "updated_at": {
            "type": "string",
            "title": "Updated At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "source",
          "item_type",
          "tags",
          "total_items",
          "enriched_items",
          "verified_items",
          "created_at",
          "updated_at"
        ],
        "title": "ListSummary"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "A Veysa API key."
      }
    }
  }
}