## Overview

This section contains everything you need to integrate the Registration Authority API: full OpenAPI specification (with operation details in the `llamadas` folder), webhook configuration, authentication, responses, and the Postman collection.

## Contents

- **[Registration Authority API (OpenAPI)](/it/products/namirialpkiaas/registration-authority/openapi)** — Full API: Registration Authority, RAO, Users, Scratchcards, Requests, eIDAS VideoID, External VideoID. All paths are under `/api/v1/`.
- **[Webhooks](/it/products/namirialpkiaas/registration-authority/enterprise-documentation/developer-documentation/callbacks/webhooks)** — Callback URL and payload for request status changes (VideoID flows).
- **[Postman collection](/it/products/namirialpkiaas/registration-authority/enterprise-documentation/developer-documentation/resources/postman)** — Quick API testing.


## Endpoint URLs

Base URL format: `https://{host}/api/{version}/{resource}/`

- **Host** — `api.uanataca.com` (production), `api.sandbox.uanataca.com` (sandbox). For External VideoID upload: `lima.uanataca.com` / `lima.sandbox.uanataca.com`.
- **Version** — `v1`.
- **Resource** — e.g. `requests`, `registrationauthorities`, `rao`, `users`, `scratchcards`. Always end the URL with a forward slash (`/`).


## Authentication

The API is authenticated with the **certificate and key** of an enabled API User (client certificate). Example with cURL:


```bash
curl --key key.pem --cert cert.pem -H "Content-Type: application/json" -d @params.json -X POST https://api.uanataca.com/api/v1/requests/
```

Example with Python (requests):


```python
import requests
requests.get(
    'https://api.uanataca.com/api/v1/scratchcards/',
    cert=('/path/to/cert.pem', '/path/to/key.pem')
)
```

## Responses

- Successful responses return JSON; structure depends on the endpoint (see OpenAPI).
- Error responses include `error` (string), `code` (HTTP-related), and `id` (Uanataca error id).
- Paginated list responses include `count`, `next`, `previous`, and `results` (max 10 objects per page). See [OpenAPI specification](/it/products/namirialpkiaas/registration-authority/openapi) for details and HTTP status codes.


## Related documentation

- [Get started](/it/products/namirialpkiaas/registration-authority/enterprise-documentation/get-started/get-started)
- [Workflows](/it/products/namirialpkiaas/registration-authority/enterprise-documentation/products-and-modules/workflows/overview)