Skip to content
Space Invoices Documentation

Suppliers

Suppliers

Supplier directory for incoming purchase documents.

Endpoints
IntroductionPOST/suppliersGET/suppliersGET/suppliers/{id}PATCH/suppliers/{id}

The Supplier object

object

Attributes

idstring
Other attributes
entity_idstring
namestring
addressstring
address_2string
post_codestring
citystring
statestring
countrystring
country_codestring
tax_numberstring
company_numberstring
peppol_idstring
emailstring
phonestring
is_tax_subjectboolean
metadata
deleted_atstring<date-time>
created_atstring<date-time>
updated_atstring<date-time>
Examplejson
{
  "id": "sup_6595a27b5d35015c3ef0c3fd",
  "entity_id": "ent_6595a27b5d35015c3ef0c3fd",
  "name": "Elektroservisi d.o.o.",
  "address": "Agrokombinatska cesta 52a",
  "address_2": null,
  "post_code": "1000",
  "city": "Ljubljana",
  "state": null,
  "country": "Slovenia",
  "country_code": "SI",
  "tax_number": "SI987654321",
  "company_number": "0987654321",
  "email": "accounts@elektroservisi.si",
  "phone": "+38640111222",
  "peppol_id": "0088:987654321",
  "is_tax_subject": true,
  "metadata": {
    "source": "manual"
  },
  "deleted_at": null,
  "created_at": "2025-10-03T08:00:00.000Z",
  "updated_at": "2025-10-03T08:00:00.000Z"
}

Create supplier

POST/suppliers

Create supplier

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

namestringrequired
Other parameters
addressstringoptional
address_2stringoptional
post_codestringoptional
citystringoptional
statestringoptional
countrystringoptional
country_codestringoptional
tax_numberstringoptional
company_numberstringoptional
peppol_idstringoptional
emailstringoptional
phonestringoptional
is_tax_subjectbooleanoptional
metadataobjectoptional
curl -X POST "https://eu.spaceinvoices.com/suppliers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Elektroservisi d.o.o.",
    "address": "Agrokombinatska cesta 52a",
    "post_code": "1000",
    "city": "Ljubljana",
    "country": "Slovenia",
    "country_code": "SI",
    "tax_number": "SI987654321",
    "company_number": "0987654321",
    "email": "accounts@elektroservisi.si",
    "phone": "+38640111222",
    "peppol_id": "0088:987654321",
    "is_tax_subject": true,
    "metadata": {
      "source": "manual"
    }
  }'
Example:
Response

Returns

idstring
Other parameters
entity_idstring
namestring
addressstring
address_2string
post_codestring
citystring
statestring
countrystring
country_codestring
tax_numberstring
company_numberstring
peppol_idstring
emailstring
phonestring
is_tax_subjectboolean
metadata
deleted_atstring<date-time>
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "sup_6595a27b5d35015c3ef0c3fd",
  "entity_id": "ent_6595a27b5d35015c3ef0c3fd",
  "name": "Elektroservisi d.o.o.",
  "address": "Agrokombinatska cesta 52a",
  "address_2": null,
  "post_code": "1000",
  "city": "Ljubljana",
  "state": null,
  "country": "Slovenia",
  "country_code": "SI",
  "tax_number": "SI987654321",
  "company_number": "0987654321",
  "email": "accounts@elektroservisi.si",
  "phone": "+38640111222",
  "peppol_id": "0088:987654321",
  "is_tax_subject": true,
  "metadata": {
    "source": "manual"
  },
  "deleted_at": null,
  "created_at": "2025-10-03T08:00:00.000Z",
  "updated_at": "2025-10-03T08:00:00.000Z"
}

List suppliers

GET/suppliers

List suppliers

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Query parameters

limitintegeroptional

Number of results per request.

Default: 10

next_cursorstringoptional

Cursor to fetch the next page of results. Use the value from pagination.next_cursor in the previous response.

prev_cursorstringoptional

Cursor to fetch the previous page of results. Use the value from pagination.prev_cursor in the previous response.

include_total_countbooleanoptional

Whether to include the total count of items in pagination.total.
Default is true.
When false, pagination.total returns -1 for better performance.

searchstringoptional

Full-text search query to filter results across multiple fields.
Searches are case-insensitive and match partial strings.
Searches across all text fields including names, descriptions, addresses, and metadata values.

curl "https://eu.spaceinvoices.com/suppliers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

dataarray of objects
paginationobject

Pagination metadata including cursors and result counts

json
{
  "data": [
    {
      "id": "sup_6595a27b5d35015c3ef0c3fd",
      "entity_id": "ent_6595a27b5d35015c3ef0c3fd",
      "name": "Elektroservisi d.o.o.",
      "address": "Agrokombinatska cesta 52a",
      "address_2": null,
      "post_code": "1000",
      "city": "Ljubljana",
      "state": null,
      "country": "Slovenia",
      "country_code": "SI",
      "tax_number": "SI987654321",
      "company_number": "0987654321",
      "email": "accounts@elektroservisi.si",
      "phone": "+38640111222",
      "peppol_id": "0088:987654321",
      "is_tax_subject": true,
      "metadata": {
        "source": "manual"
      },
      "deleted_at": null,
      "created_at": "2025-10-03T08:00:00.000Z",
      "updated_at": "2025-10-03T08:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "next_cursor": null,
    "prev_cursor": null,
    "has_more": false
  }
}

Get supplier by ID

GET/suppliers/{id}

Get supplier by ID

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Path parameters

idstring<resource-id>required

Unique resource identifier

curl "https://eu.spaceinvoices.com/suppliers/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

idstring
Other parameters
entity_idstring
namestring
addressstring
address_2string
post_codestring
citystring
statestring
countrystring
country_codestring
tax_numberstring
company_numberstring
peppol_idstring
emailstring
phonestring
is_tax_subjectboolean
metadata
deleted_atstring<date-time>
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "sup_6595a27b5d35015c3ef0c3fd",
  "entity_id": "ent_6595a27b5d35015c3ef0c3fd",
  "name": "Elektroservisi d.o.o.",
  "address": "Agrokombinatska cesta 52a",
  "address_2": null,
  "post_code": "1000",
  "city": "Ljubljana",
  "state": null,
  "country": "Slovenia",
  "country_code": "SI",
  "tax_number": "SI987654321",
  "company_number": "0987654321",
  "email": "accounts@elektroservisi.si",
  "phone": "+38640111222",
  "peppol_id": "0088:987654321",
  "is_tax_subject": true,
  "metadata": {
    "source": "manual"
  },
  "deleted_at": null,
  "created_at": "2025-10-03T08:00:00.000Z",
  "updated_at": "2025-10-03T08:00:00.000Z"
}

Update supplier

PATCH/suppliers/{id}

Update supplier

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Path parameters

idstring<resource-id>required

Unique resource identifier

Body parameters

namestringoptional
addressstringoptional
address_2stringoptional
post_codestringoptional
citystringoptional
statestringoptional
countrystringoptional
country_codestringoptional
tax_numberstringoptional
company_numberstringoptional
peppol_idstringoptional
emailstringoptional
phonestringoptional
is_tax_subjectbooleanoptional
metadataobjectoptional
curl -X PATCH "https://eu.spaceinvoices.com/suppliers/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "finance@elektroservisi.si",
    "phone": "+38640111999"
  }'
Example:
Response

Returns

idstring
Other parameters
entity_idstring
namestring
addressstring
address_2string
post_codestring
citystring
statestring
countrystring
country_codestring
tax_numberstring
company_numberstring
peppol_idstring
emailstring
phonestring
is_tax_subjectboolean
metadata
deleted_atstring<date-time>
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "sup_6595a27b5d35015c3ef0c3fd",
  "entity_id": "ent_6595a27b5d35015c3ef0c3fd",
  "name": "Elektroservisi d.o.o.",
  "address": "Agrokombinatska cesta 52a",
  "address_2": null,
  "post_code": "1000",
  "city": "Ljubljana",
  "state": null,
  "country": "Slovenia",
  "country_code": "SI",
  "tax_number": "SI987654321",
  "company_number": "0987654321",
  "email": "finance@elektroservisi.si",
  "phone": "+38640111999",
  "peppol_id": "0088:987654321",
  "is_tax_subject": true,
  "metadata": {
    "source": "manual"
  },
  "deleted_at": null,
  "created_at": "2025-10-03T08:00:00.000Z",
  "updated_at": "2025-10-04T08:00:00.000Z"
}