# UK Company Officer Lookup

> UK Company Officer Lookup is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Looks up a person by name in the UK Companies House register, returning matched officers with birth month/year and all their directorships and secretary roles with company details, status, and dates.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/uk/officer?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-company-officer-lookup-dcca4d38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aUVQk4l08hYEyhFMNb6bR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-company-officer-lookup-dcca4d38
```

Example prompt: Look up James Murdoch in the UK Companies House register and show me all his current and past directorships and secretary roles, including the companies, their status, and the dates he was appointed or resigned.

## When to prefer this

Choose this endpoint when you need structured UK corporate officer data for a named individual, including their full history of directorships and secretary roles across all companies. It is the right choice for due diligence, background checks, corporate network mapping, or verifying someone's UK business affiliations. Prefer it over general web search when you need authoritative, structured data directly from the UK Companies House register.

## Known failure modes

- Name not found in Companies House register — returns empty results
- Ambiguous name with many matches — user must specify pick index to expand a particular match
- Invalid or missing name parameter — returns 400 error
- Chosen pick index out of range — may return error or empty role list
- Companies House API unavailable — upstream timeout or error

## How this service works

Look up a person in the UK company register: matching company officers with birth month/year, then every directorship and secretary role of the chosen match (company, status, role, appointed and resigned dates).

## Output

A list of company officer matches for the given name (each with birth month/year to disambiguate), and for the selected match, a full list of all directorships and secretaryships including company name, company status (active/dissolved), role type, appointed date, and resigned date if applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Person's name"
      },
      "pick": {
       "type": "integer",
       "description": "Which match to expand (1 = first)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-company-officer-lookup-dcca4d38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)