Vendors

Manage vendor / supplier records used for purchasing and expenses.

Use cases: Use vendors to track your suppliers, link them to products, and create purchase documents.

GET/vendors

List all vendors.

Query Parameters

Name	Type	Description
`search`	string	Free-text search across relevant fields.
`page`	number	Page number (default 1).
`limit`	number	Items per page (default 50).

Request

curl -X GET "https://api.glance.co.il/vendors" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": [
    {
      "visibleId": 1,
      "name": "Supplier Co",
      "taxId": "514000000",
      "email": "orders@supplier.co",
      "createdAt": "2024-01-10T08:00:00Z"
    }
  ],
  "pagination": {
    "total": 12,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

GET/vendors/id/:visibleId

Get a single vendor.

Path Parameters

Name	Type		Description
`visibleId`	number	required	The vendor visible ID.

Request

curl -X GET "https://api.glance.co.il/vendors/id/:visibleId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "data": {
    "visibleId": 1,
    "name": "Supplier Co",
    "taxId": "514000000",
    "email": "orders@supplier.co",
    "bankNumber": "10",
    "branchNumber": "100",
    "accountNumber": "1234567",
    "createdAt": "2024-01-10T08:00:00Z"
  }
}

POST/vendors/create

Create a new vendor.

Body Parameters

Name	Type		Description
`name`	string	required	Vendor name.
`taxId`	string		Tax identification number.
`email`	string		Vendor email address.
`bankNumber`	string		Bank number.
`branchNumber`	string		Branch number.
`accountNumber`	string		Bank account number.

Request

curl -X POST "https://api.glance.co.il/vendors/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "example_name",
  "taxId": "example_taxId",
  "email": "example_email",
  "bankNumber": "example_bankNumber",
  "branchNumber": "example_branchNumber",
  "accountNumber": "example_accountNumber"
}'

Response

{
  "data": {
    "visibleId": 3,
    "name": "New Supplier Ltd",
    "taxId": "516000000",
    "email": "info@newsupplier.com",
    "createdAt": "2024-03-20T14:30:00Z"
  }
}

PUT/vendors/edit/:visibleId

Update an existing vendor.

Path Parameters

Name	Type		Description
`visibleId`	number	required	The vendor visible ID.

Body Parameters

Name	Type	Description
`name`	string	Vendor name.
`taxId`	string	Tax identification number.
`email`	string	Vendor email address.
`bankNumber`	string	Bank number.
`branchNumber`	string	Branch number.
`accountNumber`	string	Bank account number.

Request

curl -X PUT "https://api.glance.co.il/vendors/edit/:visibleId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "example_name",
  "taxId": "example_taxId",
  "email": "example_email",
  "bankNumber": "example_bankNumber",
  "branchNumber": "example_branchNumber",
  "accountNumber": "example_accountNumber"
}'

Response

{
  "data": {
    "visibleId": 1,
    "name": "Supplier Co (Updated)"
  }
}