# Remote API API

> Remote API API on Apizie: 82 endpoints (List Contract Amendment, Create Contract Amendment, Show Time Off, Update Time Off, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/finance:remote/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:remote`
- Category: Finance
- Status: byok
- Source: https://remote.com
- Page: https://apizie.tech/api/finance/remote
- OpenAPI: https://apizie.tech/api/finance/remote/openapi.json

Talent is everywhere. Opportunity is not. Remote's mission is to create opportunity everywhere, empowering employers to find and hire the best talent, and enabling individuals to build financial and personal freedom.…

## Endpoints

### List Contract Amendment
`GET https://apizie.tech/v1/finance:remote/contract-amendments-list-requests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Number of items per page |

### Create Contract Amendment
`POST https://apizie.tech/v1/finance:remote/contract-amendments-create-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Time Off
`GET https://apizie.tech/v1/finance:remote/time-off-get-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Timeoff ID |

### Update Time Off
`POST https://apizie.tech/v1/finance:remote/time-off-update-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Timeoff ID |
| body | object | yes | JSON request body |

### Update Time Off
`POST https://apizie.tech/v1/finance:remote/time-off-update-record-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Timeoff ID |
| body | object | yes | JSON request body |

### List Incentives
`GET https://apizie.tech/v1/finance:remote/incentives-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | no | Filter by Employment ID |
| status | string | no | Filter by Incentive status |
| recurring_incentive_id | string | no | Filter by Recurring Incentive id |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Create Incentive
`POST https://apizie.tech/v1/finance:remote/incentives-create-incentive` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Lists custom fields definitions
`GET https://apizie.tech/v1/finance:remote/custom-fields-list-definitions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Creates a cost estimation of employments
`POST https://apizie.tech/v1/finance:remote/cost-calculator-generate-estimation-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show Incentive
`GET https://apizie.tech/v1/finance:remote/incentives-show-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Incentive ID |

### Update Incentive
`POST https://apizie.tech/v1/finance:remote/incentives-update-incentive` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Incentive ID |
| body | object | no | JSON request body |

### Update Incentive
`POST https://apizie.tech/v1/finance:remote/incentives-update-incentive-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Incentive ID |
| body | object | no | JSON request body |

### Delete an Incentive
`POST https://apizie.tech/v1/finance:remote/incentives-remove-incentive` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Incentive ID |

### List payslips
`GET https://apizie.tech/v1/finance:remote/payslips-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | no | Employment ID |
| start_date | string | no | Filters by payslips `issued_at` field, after or on the same day than the given date |
| end_date | string | no | Filters by payslips `issued_at` field, before or or the same day than the given date |
| expected_payout_start_date | string | no | Filters by payslips `expected_payout_date` field, after or on the same day than the given date |
| expected_payout_end_date | string | no | Filters by payslips `expected_payout_date` field, before or or the same day than the given date |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Token
`POST https://apizie.tech/v1/finance:remote/oauth2-exchange-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get employment contract pending changes
`GET https://apizie.tech/v1/finance:remote/employment-contracts-get-pending-changes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |

### List Time Off
`GET https://apizie.tech/v1/finance:remote/time-off-list-records` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | no | Only show time off for a specific employment |
| timeoff_type | string | no | Filter time off by its type |
| status | string | no | Filter time off by its status |
| order | string | no | Sort order |
| sort_by | string | no | Field to sort by |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Number of items per page |

### Create Time Off
`POST https://apizie.tech/v1/finance:remote/time-off-record-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Show employment
`GET https://apizie.tech/v1/finance:remote/employments-get-employment-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |

### Update employment
`POST https://apizie.tech/v1/finance:remote/employments-update-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |
| body | object | no | JSON request body |

### Update employment
`POST https://apizie.tech/v1/finance:remote/employments-update-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |
| body | object | no | JSON request body |

### Show payslip
`GET https://apizie.tech/v1/finance:remote/payslips-show-payslip` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Payslip ID |

### Delete a Recurring Incentive
`POST https://apizie.tech/v1/finance:remote/recurring-incentives-delete-scheduled` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Recurring Incentive ID |

### Update employment
`POST https://apizie.tech/v1/finance:remote/sandbox-employment-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |
| body | object | no | JSON request body |

### Update employment
`POST https://apizie.tech/v1/finance:remote/sandbox-update-employment-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |
| body | object | no | JSON request body |

### List Employment Contract.
`GET https://apizie.tech/v1/finance:remote/employment-contracts-get-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |

### Download a resignation letter
`GET https://apizie.tech/v1/finance:remote/resignation-download-letter` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_request_id | string | yes | The employment request ID |

### List expenses
`GET https://apizie.tech/v1/finance:remote/expenses-list-records` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Create expense
`POST https://apizie.tech/v1/finance:remote/expenses-create-approved-expense` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### List Company Departments
`GET https://apizie.tech/v1/finance:remote/company-department-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | Company ID |
| paginate | boolean | no | Paginate option. Default: true. When true, paginates response; otherwise, does not. |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Number of items per page |

### Create New Department
`POST https://apizie.tech/v1/finance:remote/company-department-create-new-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Show expense
`GET https://apizie.tech/v1/finance:remote/expenses-show-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Expense ID |

### Update an expense
`POST https://apizie.tech/v1/finance:remote/expenses-update-expense` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Expense ID |
| body | object | no | JSON request body |

### Update an expense
`POST https://apizie.tech/v1/finance:remote/expenses-update-record` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Expense ID |
| body | object | no | JSON request body |

### Get Employment Profile
`GET https://apizie.tech/v1/finance:remote/identity-verification-get-employment-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |

### List Company Managers
`GET https://apizie.tech/v1/finance:remote/company-managers-list-managers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | no | A Company ID to filter the results (only applicable for Integration Partners). |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Create and invite a Company Manager
`POST https://apizie.tech/v1/finance:remote/company-managers-create-invite` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Download payslip in the PDF format
`GET https://apizie.tech/v1/finance:remote/payslips-download-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| payslip_id | string | yes | Payslip ID |

### Get token identity
`GET https://apizie.tech/v1/finance:remote/identity-get-token-info` (byok)

### Download file
`GET https://apizie.tech/v1/finance:remote/files-download-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | File ID |

### List Offboarding
`GET https://apizie.tech/v1/finance:remote/offboarding-list-requests` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | no | Filter by Employment ID |
| type | string | no | Filter by offboarding type |
| include_confidential | string | no | By default, the results do not include confidential termination requests. Send `include_confidential=true` to include confidential… |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Create Offboarding
`POST https://apizie.tech/v1/finance:remote/offboarding-create-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### List Benefit Offers By Employment
`GET https://apizie.tech/v1/finance:remote/benefit-offers-by-employment-list-by-employment` (byok)

### Show company manager user
`GET https://apizie.tech/v1/finance:remote/company-managers-show-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | User ID |

### Deletes a Company Manager user
`POST https://apizie.tech/v1/finance:remote/company-managers-delete-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | yes | User ID |

### Show a custom field value
`GET https://apizie.tech/v1/finance:remote/custom-fields-show-value` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| custom_field_id | string | yes | Custom field ID |
| employment_id | string | yes | Employment ID |

### Show Contract Amendment
`GET https://apizie.tech/v1/finance:remote/contract-amendments-show-single-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Contract amendment request ID |

### List all companies
`GET https://apizie.tech/v1/finance:remote/companies-list-all` (byok)

### Create a company
`POST https://apizie.tech/v1/finance:remote/companies-create-new-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | no | Complementary action(s) to perform when creating a company: - `get_oauth_access_tokens` returns the user's access and refresh tokens -… |
| body | object | no | JSON request body |

### Automatable Contract Amendment
`POST https://apizie.tech/v1/finance:remote/contract-amendments-check-automatability` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Create employment
`POST https://apizie.tech/v1/finance:remote/sandbox-create-employment-without-validations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Show form schema
`POST https://apizie.tech/v1/finance:remote/contract-amendments-get-form-schema` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Validate resignation request
`POST https://apizie.tech/v1/finance:remote/resignation-validate-employment-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_request_id | string | yes | The employment request ID |
| body | object | yes | JSON request body |

### List Billing Documents
`GET https://apizie.tech/v1/finance:remote/billing-documents-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| period | string | no | The month for the billing documents (in ISO-8601 format) |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### List Recurring Incentive
`GET https://apizie.tech/v1/finance:remote/recurring-incentives-list-incentives` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| status | string | no | Filter by recurring incentive status: active or deactive. |
| type | string | no | Filter by recurring incentive type. |
| note | string | no | Filter by recurring incentives that contain the value in their notes. |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Create Recurring Incentive
`POST https://apizie.tech/v1/finance:remote/recurring-incentives-create-monthly-incentive` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### List countries
`GET https://apizie.tech/v1/finance:remote/countries-list-alphabetically` (byok)

### Show region fields
`GET https://apizie.tech/v1/finance:remote/cost-calculator-show-region-fields` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes | Slug |

### Delete a Webhook Callback
`POST https://apizie.tech/v1/finance:remote/webhook-callbacks-delete-callback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Webhook Callback ID |

### List all holidays of a country
`GET https://apizie.tech/v1/finance:remote/countries-list-holidays-by-year` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| country_code | string | yes | Country code according to ISO 3166-1 3-digit alphabetic codes |
| year | string | yes | Year for the holidays |
| country_subdivision_code | string | no | Country subdivision code according to ISO 3166-2 codes |

### Download a billing document PDF
`GET https://apizie.tech/v1/finance:remote/billing-documents-download-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| billing_document_id | string | yes | The billing document's ID |

### Upload file
`POST https://apizie.tech/v1/finance:remote/files-upload-employment-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Create a Webhook Callback
`POST https://apizie.tech/v1/finance:remote/webhook-callbacks-register-callback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Creates a cost estimation of employments
`POST https://apizie.tech/v1/finance:remote/cost-calculator-create-employment-estimation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Invite employment
`POST https://apizie.tech/v1/finance:remote/employments-invite-start-enrollment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID |

### Show Time Off Balance
`GET https://apizie.tech/v1/finance:remote/time-off-balances-show-balance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| employment_id | string | yes | Employment ID for which to show the time off balance |

### Show Billing Document
`GET https://apizie.tech/v1/finance:remote/billing-documents-show-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| billing_document_id | string | yes | The billing document's ID |

### Download a receipt by id
`GET https://apizie.tech/v1/finance:remote/expenses-download-receipt-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| expense_id | string | yes | The expense ID |
| receipt_id | string | yes | The receipt ID |

### List employments
`GET https://apizie.tech/v1/finance:remote/employments-list-all` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | no | Company ID |
| email | string | no | Filters the results by employments whose login email matches the value |
| status | string | no | Filters the results by employments whose status matches the value |
| page | integer | no | Starts fetching records after the given page |
| page_size | integer | no | Change the amount of records returned per page, defaults to 20, limited to 100 |

### Create employment
`POST https://apizie.tech/v1/finance:remote/employments-create-employment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### List countries
`GET https://apizie.tech/v1/finance:remote/cost-calculator-list-countries` (byok)

### Show Offboarding
`GET https://apizie.tech/v1/finance:remote/offboarding-show-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Offboarding request ID |

### Trigger a Webhook
`POST https://apizie.tech/v1/finance:remote/sandbox-trigger-webhook-callback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### List Time Off Types
`GET https://apizie.tech/v1/finance:remote/time-off-list-types` (byok)

### Show a company
`GET https://apizie.tech/v1/finance:remote/companies-show-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | Company ID |

### Update a company
`POST https://apizie.tech/v1/finance:remote/companies-update-company` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | Company ID |
| body | object | no | JSON request body |

### Update a company
`POST https://apizie.tech/v1/finance:remote/companies-update-company-2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| company_id | string | yes | Company ID |
| body | object | no | JSON request body |

### Complete onboarding
`POST https://apizie.tech/v1/finance:remote/employments-complete-onboarding` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Approve Contract Amendment
`POST https://apizie.tech/v1/finance:remote/contract-amendments-approve-amendment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contract_amendment_request_id | string | yes | Contract amendment request ID |

### Show form schema
`GET https://apizie.tech/v1/finance:remote/countries-get-form-schema` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| country_code | string | yes | Country code according to ISO 3-digit alphabetic codes |
| form | string | yes | Name of the desired form |
| employment_id | string | no | Required for `contract_amendment` form |

### Cancel Contract Amendment
`POST https://apizie.tech/v1/finance:remote/sandbox-cancel-amendment-request` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| contract_amendment_request_id | string | yes | Contract amendment request ID |

### List Benefit Offers
`GET https://apizie.tech/v1/finance:remote/benefit-offers-list-country-summaries` (byok)

## Example
```
curl "https://apizie.tech/v1/finance:remote/contract-amendments-list-requests" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Remote API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/finance:remote/contract-amendments-list-requests with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Remote API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Remote API itself also needs your own key from gateway.remote.com.

### Can AI agents use the Remote API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:remote.

### What is the status of the Remote API API?
Needs your own provider key (bring your own key)