# Importer of Record API

Manage **Importer of Record (IOR)** entries that represent legal entities responsible
for ensuring compliance of imported goods with local customs regulations, including
filing declarations and paying duties/taxes.
These APIs allow you to:
- Create an Importer of Record definition with a unique code and associated country.
- Retrieve an Importer of Record by its unique identifier.
- Lookup and filter Importers of Record by metadata.
- Update or partially update Importer of Record details.
- Delete Importers of Record no longer in use.


Version: 1.0.0
License: PB Software License Agreement

## Servers

```
https://api-dev.sendpro360.pitneycloud.com/shipping
```

```
https://api-qa.sendpro360.pitneycloud.com/shipping
```

Sandbox Server
```
https://api-sandbox.sendpro360.pitneybowes.com/shipping
```

Production Server (uses live data)
```
https://api.sendpro360.pitneybowes.com/shipping
```

Sandbox Server for Canada
```
https://api-ppd.shipping360.pitneybowes.com/ca/shipping
```

Production Server for Canada
```
https://api.shipping360.pitneybowes.com/ca/shipping
```

## Security

### bearerAuth

Type: http
Scheme: bearer

## Download OpenAPI description

[Importer of Record API](https://docs.sendpro360.pitneycloud.com/_bundle/openapi/importerofrecord.yaml)

## Importer of Record

### Create Importer of Record

 - [POST /api/v1/importerofrecord](https://docs.sendpro360.pitneycloud.com/openapi/importerofrecord/importer-of-record/createimporterofrecord.md): Creates a new Importer of Record entry for a specific country.  
Each entry must have a unique iorCode and is tied to a countryCode.

### Get Importers of Record

 - [GET /api/v1/importerofrecord](https://docs.sendpro360.pitneycloud.com/openapi/importerofrecord/importer-of-record/getimportersofrecord.md): Returns a list of Importers of Record.

### Get Importer of Record by ID

 - [GET /api/v1/importerofrecord/{id}](https://docs.sendpro360.pitneycloud.com/openapi/importerofrecord/importer-of-record/getimporterofrecordbyid.md): Retrieves a specific Importer of Record entry by its unique id.

### Update Importer of Record

 - [PUT /api/v1/importerofrecord/{id}](https://docs.sendpro360.pitneycloud.com/openapi/importerofrecord/importer-of-record/updateimporterofrecord.md): Update the Importer of Record entry with new values for iorCode,
description, and countryCode.

### Detete Importer of Record

 - [DELETE /api/v1/importerofrecord/{id}](https://docs.sendpro360.pitneycloud.com/openapi/importerofrecord/importer-of-record/deleteimporterofrecord.md): This operation deletes the Importer of Record entry identified by id.