# Get

Para consultar los datos de un proveedor podemos generar la siguiente solicitud con el archivo `payload.json`:

```
curl "https://agents.boolfy.com/api/suppliers/get" \ 
    -H "Authorization: Bearer BOOLFY_BEARER_KEY" \
    -H "Content-Type: application/json" \
    -d @payload.json
```

El archivo `payload.json` debe tener el siguiente formato:

```json
{
    "TaxCode": "30123456780"
}
```

Detallamos en forma completa los campos de la solicitud:

<table><thead><tr><th width="221">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>TaxCode</td><td>Especifica el identificador fiscal del proveedor en el país que estas trabajando. Algunos de estos pueden ser: CUIT, CUIL, RFC y/o CNPJ entre otros.</td></tr></tbody></table>

### Respuesta

La respuesta exitosa para la consulta de datos del documentos es:

```json
{
    "code": 200,
    "msg": null,
    "response": "[{\"Name\":\"Empresa SRL",\"TaxCode\":\"30123456780\"...}]"
}
```

Detallamos el contenido del campo Response:

<table><thead><tr><th width="221">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>Name</td><td>Especifica el nombre o razon social del proveedor</td></tr><tr><td>Brand</td><td>Especifica el nombre de fantasía o marca comercial del proveedor</td></tr><tr><td>Country</td><td>Especifica el país de origen del proveedor</td></tr><tr><td>TaxType</td><td>Especifica el tipo de inscripción del proveedor</td></tr><tr><td>TaxCode</td><td>Especifica el identificador fiscal del país de origen del proveedor</td></tr><tr><td>VatType</td><td>Especifica el tipo de inscripción frente a impuestos del proveedor.</td></tr><tr><td>ExternalCode</td><td>Especifica el identificador en tu plataforma del proveedor</td></tr><tr><td>Email</td><td>Especifica el email del proveedor</td></tr><tr><td>Phone</td><td>Especifica el teléfono del proveedor</td></tr><tr><td>Notes</td><td>Especifica las notas que tiene adheridas el proveedor</td></tr><tr><td>State</td><td>Especifica el estado del proveedor. Ver <a href="../../descripcion-general-de-las-apis#estados-de-revision">Estados de revisión</a></td></tr><tr><td>Addresses</td><td>Especifica el listado de direcciones del proveedor. Ver <a href="#address">Address</a></td></tr></tbody></table>

### Address

Detallamos el contenido de las direcciones:

<table><thead><tr><th width="222">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>Name</td><td>Es el nombre del domicilio</td></tr><tr><td>Country</td><td>Especifica el país del domicilio</td></tr><tr><td>State</td><td>Especifica el estado o provincia del domicilio</td></tr><tr><td>City</td><td>Especifica la ciudad del domicilio</td></tr><tr><td>Street</td><td>Especifica el nombre de la calle o avenida del domicilio</td></tr><tr><td>Number</td><td>Especifica la altura o número de puerta del domicilio</td></tr><tr><td>Floor</td><td>En caso de existir, especifica el piso del domicilio</td></tr><tr><td>Department</td><td>En caso de existir, especifica el departamento del domicilio</td></tr><tr><td>Tower</td><td>En caso de existir, especifica la torre del domicilio</td></tr><tr><td>ZipCode</td><td>Especifica el código postal del domicilio</td></tr></tbody></table>