Customers & Suppliers

All API Operations related with Customers & Suppliers

READ Scope

List all Customers or Suppliers

Retrieves all the customers or suppliers that match with provided filters

get

/v1/business-entities

Authorizations

Query parameters

isSupplierboolean

Send this as true if you would like to list suppliers.

isCustomerboolean

Send this as true if you would like to list customers.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.nuvio.io/v1/business-entities' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "success": true,
  "errors": [
    "text"
  ],
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "entityCode": "text",
      "name": "text",
      "legalName": "text",
      "vatNumber": "text",
      "taxOffice": "text",
      "address": "text",
      "city": "text",
      "country": "text",
      "district": "text",
      "state": "text",
      "postalCode": "text",
      "email": "text",
      "phone": "text",
      "iban": "text",
      "isCustomer": true,
      "isSupplier": true
    }
  ]
}

OK

Get a Customer or Supplier by ID

Retrieves a customer or supplier by its unique ID or user-generated customer or supplier ID.

get

/v1/business-entities/{id}

Authorizations

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.nuvio.io/v1/business-entities/{id}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "success": true,
  "errors": [
    "text"
  ],
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "entityCode": "text",
    "name": "text",
    "legalName": "text",
    "vatNumber": "text",
    "taxOffice": "text",
    "address": "text",
    "city": "text",
    "country": "text",
    "district": "text",
    "state": "text",
    "postalCode": "text",
    "email": "text",
    "phone": "text",
    "iban": "text",
    "isCustomer": true,
    "isSupplier": true
  }
}

OK

WRITE Scope

Create a new Customer or Supplier

Creates a new Customer or Supplier from scratch

post

/v1/business-entities

Authorizations

Body

application/jsontext/jsonapplication/*+json

entityCodestring

A unique code for this customer / supplier. Should be a unique alpha numeric string.

namestringrequired

A short name for this customer / supplier. This will be the visible name of this business entity.

isCustomerboolean

Should be true if this business entity is a customer.

isSupplierboolean

Should be true if this business entity is a supplier.

legalNamestring

Legal company name for this business entity that is going to be used in invoices and billing.

vatNumberstring

TaxID or VAT number of the business entity.

taxOfficestring

Registered Tax office.

addressstring

Billing Address of the business entity.

citystring

City of the registered billing address.

countrystring

Country of the registered billing address. You can find the available countries here.

districtstring

District / region of the registered billing address.

statestring

State of the registered billing address.

postalCodestring

Postal code of the registered billing address.

emailstring

Contact person's email

phonestring

Company's or contact person's phone

ibanstring

IBAN number of the bank account of the business entity.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.nuvio.io/v1/business-entities' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"name":"text"}'

200

200

{
  "success": true,
  "errors": [
    "text"
  ],
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "entityCode": "text",
    "name": "text",
    "legalName": "text",
    "vatNumber": "text",
    "taxOffice": "text",
    "address": "text",
    "city": "text",
    "country": "text",
    "district": "text",
    "state": "text",
    "postalCode": "text",
    "email": "text",
    "phone": "text",
    "iban": "text",
    "isCustomer": true,
    "isSupplier": true
  }
}

OK

UPDATE Scope

Update Customer or Supplier

Updates an existing customer or supplier

put

/v1/business-entities/{id}

Authorizations

Path parameters

idstring uuidrequired

Body

application/jsontext/jsonapplication/*+json

entityCodestring

A unique code for this customer / supplier. Should be a unique alpha numeric string.

namestring

A short name for this customer / supplier. This will be the visible name of this business entity.

isCustomernullable boolean

Should be true if this business entity is a customer.

isSuppliernullable boolean

Should be true if this business entity is a supplier.

legalNamestring

Legal company name for this business entity that is going to be used in invoices and billing.

vatNumberstring

TaxID or VAT number of the business entity.

taxOfficestring

Registered Tax office.

addressstring

Billing Address of the business entity.

citystring

City of the registered billing address.

countrystring

Country of the registered billing address. You can find the available countries here.

districtstring

District / region of the registered billing address.

statestring

State of the registered billing address.

postalCodestring

Postal code of the registered billing address.

emailstring

Contact person's email

phonestring

Company's or contact person's phone

ibanstring

IBAN number of the bank account of the business entity.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.nuvio.io/v1/business-entities/{id}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json'

200

200

{
  "success": true,
  "errors": [
    "text"
  ],
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "entityCode": "text",
    "name": "text",
    "legalName": "text",
    "vatNumber": "text",
    "taxOffice": "text",
    "address": "text",
    "city": "text",
    "country": "text",
    "district": "text",
    "state": "text",
    "postalCode": "text",
    "email": "text",
    "phone": "text",
    "iban": "text",
    "isCustomer": true,
    "isSupplier": true
  }
}

OK