# NIF.pt — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for Portuguese companies by name or NIF tax identification number to instantly retrieve their official business information. Find company details including registration status, legal data, and tax information to verify businesses or conduct due diligence.

**Category:** Business Directories | **Website:** [www.nif.pt/](https://www.nif.pt/) | **Docs:** [parse.bot/marketplace/2c9f4d6c-8ba5-474b-b70f-d6dfcdbca19b/nif-pt-api](https://parse.bot/marketplace/2c9f4d6c-8ba5-474b-b70f-d6dfcdbca19b/nif-pt-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nif-pt-api-2c9f4d6c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company

Get detailed company information by NIF (Número de Identificação Fiscal). Returns the company name and registered location for the given 9-digit Portuguese tax identification number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `nif` | string | Yes | 9-digit Portuguese tax identification number (e.g. 506467473). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nif-pt-api-2c9f4d6c/get_company \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nif":"<string>"}'
```

### search_companies

Search Portuguese companies by name. Returns all matching companies with their NIF, name, and location. A single page of results is returned per query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Company name or partial name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nif-pt-api-2c9f4d6c/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```