BillptGetContacts

Description

Gets contacts/customers from Bill.pt. Supports getting a specific one by ID or listing with pagination and search by name or NIF.

Configuration

Field	Type	Required	Description
credentials_id	credentials	Yes	Bill.pt credential
contact_id	text	No	Specific contact ID (if empty, lists all)
search	text	No	Text to filter by name or NIF
per_page	number	No	Results per page (default: 50)
page	number	No	Page number (default: 1)

Credentials

This module requires a billpt type credential with the following fields:

• API Token: Bill.pt API access token

Output

Individual:

{
  "success": true,
  "contact": { "id": 123, "name": "...", ... }
}

List:

{
  "success": true,
  "contacts": [ ... ],
  "total": 150,
  "page": 1
}

API

• GET /contacts/{id} - Individual contact
• GET /contacts - List contacts

Usage Example

Get contact by ID

{
  "contact_id": "123"
}

Search contacts by name

{
  "search": "Empresa XYZ",
  "per_page": 20
}

Notes

• If contact_id is provided, a single contact is returned
• If contact_id is not provided, all contacts are listed with pagination
• The search field filters by name and NIF

Related Nodes

• BillptCreateContact - Create contact
• BillptCreateDocument - Create tax document
• BillptGetDocuments - Get documents