List contractors

Contractors from your list, searchable by name or tax number.

GET https://cotlet.dev/api/v1/ifirma/contractors

read

Returns contractors saved under Firma, Kontrahenci. Search by NIP or name to find a buyer or supplier before you invoice or book a cost. Without a filter it returns the first page.

Parameters

Parameters: list_contractors
NameTypeDescription
name string string Contractor name or part of it.
nip string string Tax number (NIP).
page integer integer Page number. Default: 1.

Request

cURL
curl https://cotlet.dev/api/v1/ifirma/contractors \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("ifirma", "list_contractors")
Node.js
const result = await cotlet.call('ifirma', 'list_contractors');
CLI
cotlet call ifirma list_contractors

Example response

JSON

{
  "contractors": [
    {
      "id": "c_4817",
      "name": "Blue Fern Studio",
      "nip": "1234563218",
      "email": "billing@bluefern.example",
      "city": "Gdansk",
      "postal_code": "80-001",
      "country_code": "PL"
    }
  ],
  "page": 1
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.