In this article, you can read about retrieving companies, candidates, company contacts, and projects filtered by their last updated date and time via the API.
All four endpoints below work the same way: add updated to the fields parameter, then use the optional updated query parameter to filter results to records updated on or after a given date and time. This is useful for syncing only records that have changed since a previous check.
Note
It is required to include both date and time as the value for the updated key, e.g.2026-03-01 20:00:00.
Get Companies by Updated Value
GET
Retrieves companies with the updated value included, by adding updated to the fields parameter. Companies can be filtered by a specific updated value using the optional updated query parameter – for example, updated=2026-03-01 20:00:00 lists companies that were updated on or after 2026-03-01 20:00:00.
https://api.recman.io/v2/get/index.php?scope=company&key=
{{api_key}}&page=1&fields=updated&updated=2026-03-01 20:00:00| Field | Type | Required | Description |
|---|---|---|---|
| scope | string | Required | Must be set to company |
| key | string | Required | Your API key |
| page | integer | Required | Page number |
| fields | string | Required | Must include updated to return the updated value for each record |
| updated | date-time | Optional | Search parameter. Filters results to companies updated on or after this date and time, format "YYYY-MM-DD HH:mm:ss" |
Get Candidates by Updated Value
GET
Retrieves candidates with the updated value included, by adding updated to the fields parameter. Candidates can be filtered by a specific updated value using the optional updated query parameter – for example, updated=2026-03-01 20:00:00 lists candidates that were updated on or after 2026-03-01 20:00:00.
https://api.recman.io/v2/get/index.php?scope=candidate&key=
{{api_key}}&page=1&fields=updated&updated=2026-03-01 20:00:00| Field | Type | Required | Description |
|---|---|---|---|
| scope | string | Required | Must be set to candidate |
| key | string | Required | Your API key |
| page | integer | Required | Page number |
| fields | string | Required | Must include updated to return the updated value for each record |
| updated | date-time | Optional | Search parameter. Filters results to candidates updated on or after this date and time, format "YYYY-MM-DD HH:mm:ss" |
Get Company Contacts by Updated Value
GET
Retrieves company contacts with the updated value included, by adding updated to the fields parameter. Company contacts can be filtered by a specific updated value using the optional updated query parameter – for example, updated=2026-03-01 20:00:00 lists company contacts that were updated on or after 2026-03-01 20:00:00.
https://api.recman.io/v2/get/index.php?scope=companyContact&key=
{{api_key}}&page=1&fields=updated&updated=2026-03-01 20:00:00| Field | Type | Required | Description |
|---|---|---|---|
| scope | string | Required | Must be set to companyContact |
| key | string | Required | Your API key |
| page | integer | Required | Page number |
| fields | string | Required | Must include updated to return the updated value for each record |
| updated | date-time | Optional | Search parameter. Filters results to company contacts updated on or after this date and time, format "YYYY-MM-DD HH:mm:ss" |
Get Projects by Updated Value
GET
Retrieves projects with the updated value included, by adding updated to the fields parameter. Projects can be filtered by a specific updated value using the optional updated query parameter – for example, updated=2026-03-01 20:00:00 lists projects that were updated on or after 2026-03-01 20:00:00.
https://api.recman.io/v2/get/index.php?scope=project&key=
{{api_key}}&page=1&fields=updated&updated=2026-03-01 20:00:00| Field | Type | Required | Description |
|---|---|---|---|
| scope | string | Required | Must be set to project |
| key | string | Required | Your API key |
| page | integer | Required | Page number |
| fields | string | Required | Must include updated to return the updated value for each record |
| updated | date-time | Optional | Search parameter. Filters results to projects updated on or after this date and time, format "YYYY-MM-DD HH:mm:ss" |