# 4zida Agency API Documentation

Read the agency behind one listing, by the listing id from /search. The answer has the agency id, name, type, address, email, register number, years of service, logo and page link, and the advertiser name, type and profile link. 4zida publishes no separate agency profile data, so this comes from the listing. A listing of a private seller has no agency and returns a non-billable 404. Phone numbers are never returned.

- **Documentation:** [https://scrappa.co/docs/4zida-api/fourzida_agency](https://scrappa.co/docs/4zida-api/fourzida_agency)
- **API group:** 4zida API
- **Endpoint:** `GET https://scrappa.co/api/4zida/v1/agency`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | 24 character id of a listing that an agency posted. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/4zida/v1/agency?id=6a3964dc4344218a2d00fd24"
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing, unknown or invalid, or 4zida cannot resolve a filter value. The response is not billable. |
| 404 | Resource Not Found | The requested 4zida resource does not exist. The response is not billable. |
| 503 | Unexpected Upstream Response | 4zida answered with a body that is not the documented shape. The response is not billable. |
| 503 | Upstream Unavailable | 4zida was temporarily unavailable or blocked the request. The response is not billable and the request never answers 429. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)