{"id":"e770c2db-32c0-4ed3-b4dc-f921e31d3e79","slug":"zephira-ai-api","name":"zephira.ai API","description":"zephira.ai API","front_facing_description":"Search global company registries to instantly access official corporate information, officer details, and registration data from government sources worldwide. Retrieve verified company profiles, leadership information, and corporate records all in one place.","source_url":"https://zephira.ai/","is_authenticated":false,"canonical_scraper_id":"45d887ca-d7bf-41a7-81d2-2e17fc3d0b22","apis":[{"method":"POST","endpoint_name":"search_companies","description":"Full-text search for companies by name, registration number, VAT, LEI, or ticker across 150+ jurisdictions. Returns up to 10 matching company summaries per query. Results are auto-iterated.","input_params":{"query":{"type":"string","required":true,"description":"Company name, registration number, VAT, LEI, or ticker to search for.","domain":{"kind":"open","example":"Global Database","generator":{"type":"static","value":"Global Database"}}},"jurisdiction":{"type":"string","required":false,"description":"ISO 3166-1 alpha-2 country code to filter results by jurisdiction (e.g. 'gb', 'us'). Omitted returns results from all jurisdictions.","domain":{"kind":"open","example":"gb","generator":{"type":"static","value":""}}}},"return_schema":{"type":"object","fields":{"total":"integer count of results returned","companies":"array of company summaries with id, name, status, country_code, and registration_number"},"sample":{"data":{"total":10,"companies":[{"id":"22401777","name":"DATABASE SERVICE PROVIDER GLOBAL LTD","status":"Active","country_code":"GB","registration_number":"03898451"},{"id":"1104884213","name":"GLOBAL DATABASE - INFORMATICA LTDA.","status":"Active","country_code":"BR","registration_number":"04536081000108"}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.companies","op":"array_min_len","value":1},{"path":"$.data.companies[*]","op":"field_present","value":"id"}],"empty_is_valid":true,"recipe_version":1}},{"method":"POST","endpoint_name":"search_officers","description":"Full-text search for corporate officers by name across 150+ jurisdictions. Returns matching officer appointments with their associated company information. Results are auto-iterated.","input_params":{"query":{"type":"string","required":true,"description":"Officer name to search for.","domain":{"kind":"open","example":"John Smith","generator":{"type":"static","value":"John Smith"}}},"jurisdiction":{"type":"string","required":false,"description":"ISO 3166-1 alpha-2 country code to filter results by jurisdiction (e.g. 'gb', 'us'). Omitted returns results from all jurisdictions.","domain":{"kind":"open","example":"gb","generator":{"type":"static","value":""}}}},"return_schema":{"type":"object","fields":{"total":"integer count of results returned","officers":"array of officer records with full_name, officer_role, company_name, address_country, and resigned_at"},"sample":{"data":{"total":50,"officers":[{"full_name":"Peter John Smith","resigned_at":"1997-07-11","company_name":"GARDMAN LIMITED","officer_role":"Director","address_country":"GB"},{"full_name":"Andrew John Smith","resigned_at":null,"company_name":"PURENETWORKING LIMITED","officer_role":"Director","address_country":"GB"}]},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.officers","op":"array_min_len","value":1},{"path":"$.data.officers[*]","op":"field_present","value":"full_name"}],"empty_is_valid":true,"recipe_version":1}},{"method":"POST","endpoint_name":"get_company_details","description":"Retrieve detailed company information including status, registration number, incorporation date, VAT number, legal form, registered address, and website. Requires a company_id obtained from search_companies.","input_params":{"company_id":{"type":"string","required":true,"description":"Numeric company identifier from search_companies results.","domain":{"kind":"derived","generator":{"path":"$.data.companies[0].id","type":"derived","from_endpoint":"search_companies"}}}},"return_schema":{"type":"object","fields":{"name":"company legal name","status":"current company status (e.g. Active, Inactive)","country":"country of registration","website":"company website URL if available","legal_form":"legal entity type","vat_number":"VAT registration number if available","incorporation_date":"date of incorporation (YYYY-MM-DD)","registered_address":"full registered office address","registration_number":"official registration number"},"sample":{"data":{"name":"DATABASE SERVICE PROVIDER GLOBAL LTD","status":"Active","country":"United Kingdom","website":"http://www.dsp.co.uk/","legal_form":"Private limited company (Ltd.)","vat_number":"GB411334251","incorporation_date":"1999-12-22","registered_address":"Broadfield Law Uk Llp, One Bartholomew Close, London, United Kingdom","registration_number":"03898451"},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.name","op":"not_null"},{"path":"$.data.registration_number","op":"not_null"}],"empty_is_valid":false,"recipe_version":1}},{"method":"POST","endpoint_name":"get_company_officers","description":"Retrieve the list of officers (directors, secretaries) for a specific company. Includes appointment dates, resignation dates, job titles, and address information. Requires a company_id obtained from search_companies. Returns the first page of officers along with total_pages and total_results metadata.","input_params":{"company_id":{"type":"string","required":true,"description":"Numeric company identifier from search_companies results.","domain":{"kind":"derived","generator":{"path":"$.data.companies[0].id","type":"derived","from_endpoint":"search_companies"}}}},"return_schema":{"type":"object","fields":{"officers":"array of officer records","total_pages":"total number of pages available","total_results":"total number of officer records"},"sample":{"data":{"officers":[{"id":581912562,"job_title":"Director","last_name":"Doe","first_name":"John","resigned_at":"2016-04-27","work_status":"RESIGNED","appointed_at":"2012-01-01","address_line_1":"123 Main St, Springfield, IL 62704","address_country":"GB","address_locality":null,"date_of_birth_year":1964,"address_postal_code":"EC1Y 2AB","date_of_birth_month":11}],"total_pages":7,"total_results":35},"status":"success"}},"initiates_session":false,"price":1,"verification":{"assertions":[{"path":"$.status","op":"equals","value":"success"},{"path":"$.data.officers","op":"array_min_len","value":1},{"path":"$.data.officers[*]","op":"field_present","value":"first_name"}],"empty_is_valid":false,"recipe_version":1}}],"sample_inputs":{},"prefill_inputs":{"search_companies":{"query":"Global Database","jurisdiction":""},"search_officers":{"query":"John Smith","jurisdiction":""}},"last_verified_at":null,"endpoint_health":[],"sdk_usage_example":{"code":"\"\"\"Walkthrough: Zephira KYB SDK — bounded, re-runnable; every call capped.\"\"\"\nfrom parse_apis.zephira_ai_api import Zephira, ParseError\n\nclient = Zephira()\n\n# Search for companies by name — limit caps total items.\nfor company in client.company_summaries.search(query=\"Global Database\", limit=3):\n    print(company.name, company.status, company.country_code)\n\n# Drill-down: take one company, get full details.\nhit = client.company_summaries.search(query=\"Global Database\", limit=1).first()\ntry:\n    full = hit.details()\n    print(full.name, full.registration_number, full.incorporation_date)\nexcept ParseError as e:\n    print(\"error:\", e)\n\n# Get officers for that company.\nfor officer in full.officers(limit=3):\n    print(officer.first_name, officer.last_name, officer.job_title, officer.work_status)\n\n# Search officers by name.\nfor result in client.officer_summaries.search(query=\"John Smith\", limit=3):\n    print(result.full_name, result.officer_role, result.company_name)\n\nprint(\"exercised: company_summaries.search / details / officers / officer_summaries.search\")\n","shape":"parse_sdk","endpoints":["search_companies","search_officers","get_company_details","get_company_officers"],"has_session":false,"hover_map":[{"line":19,"col":4,"len":7,"label":"officer: Officer","kind":"variable"},{"line":4,"col":9,"len":7,"label":"Zephira — API client","kind":"class"},{"line":13,"col":4,"len":4,"label":"full: Company","kind":"variable"},{"line":19,"col":20,"len":8,"label":"officers() → List[Officer]","kind":"method"},{"line":13,"col":15,"len":7,"label":"details() → Company","kind":"method"},{"line":14,"col":15,"len":4,"label":"name: str","kind":"field"},{"line":14,"col":26,"len":19,"label":"registration_number: str","kind":"field"},{"line":14,"col":52,"len":18,"label":"incorporation_date: str","kind":"field"},{"line":19,"col":15,"len":4,"label":"full: Company","kind":"variable"},{"line":20,"col":18,"len":10,"label":"first_name: str","kind":"field"},{"line":20,"col":38,"len":9,"label":"last_name: str","kind":"field"},{"line":20,"col":57,"len":9,"label":"job_title: Optional[str]","kind":"field"},{"line":20,"col":76,"len":11,"label":"work_status: Optional[str]","kind":"field"},{"line":14,"col":10,"len":4,"label":"full: Company","kind":"variable"},{"line":14,"col":21,"len":4,"label":"full: Company","kind":"variable"},{"line":14,"col":47,"len":4,"label":"full: Company","kind":"variable"},{"line":20,"col":10,"len":7,"label":"officer: Officer","kind":"variable"},{"line":20,"col":30,"len":7,"label":"officer: Officer","kind":"variable"},{"line":20,"col":49,"len":7,"label":"officer: Officer","kind":"variable"},{"line":20,"col":68,"len":7,"label":"officer: Officer","kind":"variable"}]},"sdk_delivery_state":"legacy","summary":"Search and retrieve official company data, officers, and corporate details from government registries worldwide via Zephira.ai.","updated_at":"2026-08-02T14:47:02.754736+00:00","user_variants":[],"latest_version":1,"user_status":null,"user_scraper_id":null,"contributes_to_marketplace":true,"pinned_version":null,"seo_content":{"faqs":[{"a":"Zephira.ai does offer its own data platform at zephira.ai, but access terms, documentation depth, and direct API availability may vary. This Parse API exposes the same registry data through a consistent interface without requiring a separate Zephira account.","q":"Does Zephira.ai provide an official developer API?"},{"a":"It returns nine fields: the company's legal name, current status (e.g. Active or Inactive), country of registration, website URL (when available), legal_form, vat_number, incorporation_date in YYYY-MM-DD format, registered_address, and registration_number. Not every field is populated for every jurisdiction — availability depends on what the relevant government registry discloses.","q":"What does get_company_details return beyond basic registration info?"},{"a":"Not currently. The API covers company profiles, registration details, and officer appointment records. It does not expose financial filings, annual accounts, or document downloads. You can fork this API on Parse and revise it to add an endpoint targeting filing or document data where the source registry makes that available.","q":"Can I retrieve a company's full filing history or annual accounts through this API?"},{"a":"The `get_company_officers` endpoint returns the first page of officers along with `total_pages` and `total_results` so you know how many additional pages exist. To retrieve subsequent pages you need to make additional calls. The `search_companies` and `search_officers` endpoints auto-iterate, returning up to 10 summaries per query rather than requiring manual page handling.","q":"How does pagination work for officer results?"},{"a":"Not currently. The endpoints cover directors, secretaries, and similar appointed officers along with their roles and dates. Shareholder registers and beneficial ownership (UBO) data are not part of the current response schema. You can fork this API on Parse and revise it to add a beneficial ownership endpoint if the underlying registry exposes that data for a given jurisdiction.","q":"Is shareholder or beneficial ownership data available?"}],"keywords":["company registry API","corporate officer search API","global business registration data API","company incorporation date API","VAT number lookup API","LEI lookup API","director search API worldwide","KYC company verification API","registered address lookup API","legal entity data API","cross-jurisdiction company search","government registry data API","company status check API","corporate compliance data API"],"use_cases":["Automate KYC workflows by verifying company status, incorporation date, and registered address from official registries","Screen potential business partners by checking officer roles and resignation dates across multiple jurisdictions","Build a corporate ownership explorer by linking officers to multiple company records via search_officers","Enrich CRM or lead records with legal_form, vat_number, and registration_number from get_company_details","Monitor director appointments and resignations across a portfolio of companies using get_company_officers","Cross-reference LEI or VAT numbers against official registry data for financial compliance checks","Aggregate incorporation dates and legal forms across jurisdictions for market-entry research"],"meta_title":"Zephira.ai API – Global Company Registry Data","generated_at":"2026-08-02T14:48:23.291468+00:00","lead_paragraph":"The Zephira.ai API provides 4 endpoints for querying official corporate registry data across 150+ jurisdictions. Use `search_companies` to find companies by name, registration number, VAT, LEI, or ticker, then call `get_company_details` to retrieve incorporation dates, registered addresses, legal forms, and VAT numbers. A parallel set of officer endpoints lets you search and retrieve directors, secretaries, and their appointment histories.","schema_version":2,"meta_description":"Search and retrieve official company profiles, officer records, and registration data from 150+ government registries worldwide via the Zephira.ai API.","primary_category":"b2b_directory","long_description_md":"## Company Search and Detail Retrieval\n\nThe `search_companies` endpoint accepts a `query` string — company name, registration number, VAT, LEI, or stock ticker — and an optional `jurisdiction` parameter (ISO 3166-1 alpha-2, e.g. `gb`, `de`, `us`). It returns an array of company summaries, each containing `id`, `name`, `status`, `country_code`, and `registration_number`. The `id` from these results is required as `company_id` input for `get_company_details`, which returns the full corporate profile: `name`, `status`, `country`, `website`, `legal_form`, `vat_number`, `incorporation_date` (YYYY-MM-DD), `registered_address`, and `registration_number`.\n\n## Officer Search and Appointment Records\n\n`search_officers` works similarly to company search: supply an officer name as `query`, with an optional `jurisdiction` filter. Each result in the `officers` array includes `full_name`, `officer_role`, `company_name`, `address_country`, and `resigned_at` — letting you see whether an appointment is current or historical. For a specific company's full officer list, `get_company_officers` takes a `company_id` and returns paginated results with `total_pages` and `total_results` alongside the `officers` array, which includes appointment dates, resignation dates, job titles, and address data.\n\n## Coverage and Workflow\n\nAll four endpoints draw from government-sourced registry data spanning 150+ countries. The typical workflow is two steps: run a search endpoint to obtain identifiers, then pass those identifiers to the detail endpoints. Both search endpoints auto-iterate results, and officer results from `get_company_officers` expose pagination metadata so you can retrieve large appointment lists in full.","generated_with_model":"global.anthropic.claude-sonnet-4-6","secondary_categories":["government_public","finance"]},"primary_category":"b2b_directory","secondary_categories":["government_public","finance"],"access_requirements":[]}