# Sinao API API

> Sinao API API on Apizie: 281 endpoints (List apps, Create an app, Get invitation informations, Delete an invitation from token, …) 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://www.apizie.tech/v1/finance:sinao/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Sinao API for account management, apps administration and network exploration

## Endpoints

### List apps
`GET https://www.apizie.tech/v1/finance:sinao/app-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create an app
`POST https://www.apizie.tech/v1/finance:sinao/app-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| organization_name | string | yes | Organization name. Minimum 3 characters with 1 alpha |

### Get invitation informations
`GET https://www.apizie.tech/v1/finance:sinao/app-policies-registration-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| accessToken | string | yes |  |

### Delete an invitation from token
`POST https://www.apizie.tech/v1/finance:sinao/app-policies-registration-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| accessToken | string | yes |  |

### Create an User by invitation
`POST https://www.apizie.tech/v1/finance:sinao/app-policies-registration-register` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| accessToken | string | yes |  |
| password | string | yes | Password for account |
| firstname | string | no | First name of user before account creation / account link |
| lastname | string | no | Last name of user before account creation / account link |
| cgu | boolean | yes | User has valided CGU ? |

### Get an app
`GET https://www.apizie.tech/v1/finance:sinao/app-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Get policies for an app
`GET https://www.apizie.tech/v1/finance:sinao/app-policies-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### List invitations
`GET https://www.apizie.tech/v1/finance:sinao/app-policies-invitations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Invite an user
`POST https://www.apizie.tech/v1/finance:sinao/app-policies-invitations-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| email | string | yes | Email for invitation. Will be used to account creation or account matching with an existing user |
| policy_profile_id | integer | yes | Profile for policies set |
| firstname | string | no | First name of user before account creation / account link |
| lastname | string | no | Last name of user before account creation / account link |
| civility | string | no | Last name of user before account creation / account link |
| password | string | no | Password for new user |

### Delete an invitation
`POST https://www.apizie.tech/v1/finance:sinao/app-policies-invitations-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes |  |

### Get profiles
`GET https://www.apizie.tech/v1/finance:sinao/app-policies-profiles-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Get police for an user
`GET https://www.apizie.tech/v1/finance:sinao/app-policies-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| userId | string | yes |  |

### Update police for an user
`POST https://www.apizie.tech/v1/finance:sinao/app-policies-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| userId | string | yes |  |
| policy_profile_id | integer | yes |  |

### Delete police for an user
`POST https://www.apizie.tech/v1/finance:sinao/app-policies-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| userId | string | yes |  |

### List categories
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-categories-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a category
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-categories-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | no |  |
| description | string | no |  |
| type | string | no |  |

### Get a category
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-categories-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID |

### Update a category
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-categories-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID |
| name | string | no |  |
| description | string | no |  |
| type | string | no |  |

### Remove a category
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-categories-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID |

### List accounting entries
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-entries-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### List Account
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-accounts-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a Account
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-accounts-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| journalcode | string | no |  |
| name | string | no |  |
| description | string | no |  |
| keywords | string | no |  |
| accounting_number | string | no |  |
| is_cashflow | boolean | no |  |
| is_sales | boolean | no |  |
| is_purchase | boolean | no |  |

### Create many accounts
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-accounts-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| data | array | yes | List of accounts. Without ID for insert |

### Get a Account
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-accounts-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of Account |

### Update a Account
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-accounts-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of Account |
| journalcode | string | no |  |
| name | string | no |  |
| description | string | no |  |
| keywords | string | no |  |
| accounting_number | string | no |  |
| is_cashflow | boolean | no |  |
| is_sales | boolean | no |  |
| is_purchase | boolean | no |  |

### Remove a Account
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-accounts-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of Account |

### Get all api keys
`GET https://www.apizie.tech/v1/finance:sinao/app-apikeys-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create new API key
`POST https://www.apizie.tech/v1/finance:sinao/app-apikeys-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | yes | Key name |
| api_partner_id | integer | no | Partner ID for official connexion |

### Remove an api key
`POST https://www.apizie.tech/v1/finance:sinao/app-apikeys-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | string | yes | Automatically added |

### Get all api parners
`GET https://www.apizie.tech/v1/finance:sinao/app-apipartners-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### List attachments
`GET https://www.apizie.tech/v1/finance:sinao/app-attachments-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Attach a file on an object
`POST https://www.apizie.tech/v1/finance:sinao/app-attachments-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| type | string | yes | Object to attach file |
| attachable_id | integer | no | Object id |
| file | string | no | File to attach |

### Recreate S.A.P attestations
`POST https://www.apizie.tech/v1/finance:sinao/app-sap-attestations-generate-sap-attestations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| year | integer | no | year number to generate |

### Download a list of attachments in pdf into a .zip file
`GET https://www.apizie.tech/v1/finance:sinao/app-attachments-download` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| ids | string | yes | Array of attachments id |
| type | string | yes | Type of attachment |

### Download a list of SAP attestations in pdf into a .zip file
`GET https://www.apizie.tech/v1/finance:sinao/app-sap-attestations-download` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| ids | string | yes | Array of attachments id |
| type | string | yes | Type of attachment |

### Get attachment by id
`GET https://www.apizie.tech/v1/finance:sinao/app-attachments-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Attachment id |

### Detach a file from id
`POST https://www.apizie.tech/v1/finance:sinao/app-attachments-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Attachment id |

### Download the attachment as pdf
`GET https://www.apizie.tech/v1/finance:sinao/app-attachments-redirect-to-public-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Attachment id to download |
| random | integer | yes | random number to force fresh pdf |

### List BankDetails
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-bankdetails-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a BankDetails
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-bankdetails-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | no |  |
| iban | string | no |  |
| bic | string | no |  |

### Get a BankDetails
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-bankdetails-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of BankDetails |

### Update a BankDetails
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-bankdetails-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of BankDetails |
| name | string | no |  |
| iban | string | no |  |
| bic | string | no |  |

### Remove a BankDetails
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-bankdetails-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of BankDetails |

### List banks connected to bankin
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Remove a Bankin synchronization
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| item_id | integer | yes |  |

### Get the link to the funnel to connect a bank with Sinao
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-connect` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Triggers synchronization at Bankin then synchronizes transactions with Sinao
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-synchronize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | no | Optional item id to refresh. If set, triggers a refresh at Bankin before synchronizing transactions |
| is_incremential | boolean | no | The value 'false' triggers a non-incremental syncronization of the maximum possible duration. The value 'true' updates the transactions… |

### Get the link to the funnel to edit password
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-url-edit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes |  |

### Get the link to the funnel to start manually a synchronization (SCA)
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-url-sync` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes |  |

### Get the link to the funnel to validate a pro item (SCA)
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-url-validate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes |  |

### Select accounts to synchronize
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-banks-select-accounts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes |  |
| bank_account_ids | array | no | List of enables accounts |

### List CashflowSource
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-cashflowsources-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a CashflowSource
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-cashflowsources-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | no |  |
| identifiant | string | no |  |
| type | string | no |  |
| balance_amount | integer | no |  |
| account_type | string | no |  |
| parent_cashflow_source_id | integer | no |  |

### Get a CashflowSource
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-cashflowsources-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of CashflowSource |

### Update a CashflowSource
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-cashflowsources-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of CashflowSource |
| name | string | no |  |
| identifiant | string | no |  |
| type | string | no |  |
| balance_amount | integer | no |  |
| account_type | string | no |  |
| parent_cashflow_source_id | integer | no |  |

### Remove a CashflowSource
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-cashflowsources-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of CashflowSource |

### Merge many contacts
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-transform-merge` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| contacts | array | yes |  |

### Send emails
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-email-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| from | string | no |  |
| messages | array | no |  |
| need_copy_bcc | boolean | no |  |

### Send an email
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-email-send` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| from | string | no |  |
| recipients | array | yes |  |
| recipients_cc | array | no |  |
| recipients_bcc | array | no |  |
| title | string | no |  |
| body | string | no |  |
| documents | array | yes |  |
| need_copy_bcc | boolean | no |  |

### Get an establishment
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-establishments-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of an establishment |

### Update an establishment
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-establishments-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of an establishment |
| name | string | no |  |
| phones | array | no |  |
| emails | array | no |  |
| nic | string | no | Establishment number (french NIC) |
| place | object | no |  |

### Remove an establishment
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-establishments-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of establishment |

### List ExportEntity
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-export-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a ExportEntity
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-export-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| until | string | yes |  |

### Get the ACD UUID for authentification
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-export-acd-compta-get-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Register ACD identifiants
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-export-acd-compta-set-uuid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| login | string | yes | the login provided by ACD Compta |
| password | string | yes | the password provided by ACD Compta |
| base | string | yes | Your ACD account number (3XXXX) |
| cnx | string | yes | your CNX by ACD Compta |

### Download the export entity as zip
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-export-download` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| format | string | no | The export format can be a FEC (universal - similar to the French legal file 'Fichier des Ecritures Comptables') or specific for… |
| export_entities_ids | array | no |  |
| start_at | string | no | Automatically find export entities from a date range |
| end_at | string | no | Automatically find export entities from a date range |
| since | string | no | Automatically find export entities since a date |
| since_last | boolean | no | Automatically find the export entities since the last export downloaded |

### List ExportEntity
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-export-list-by-months` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Get a ExportEntity
`GET https://www.apizie.tech/v1/finance:sinao/app-accounting-export-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of ExportEntity |

### Remove a ExportEntity
`POST https://www.apizie.tech/v1/finance:sinao/app-accounting-export-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of ExportEntity |

### List invoices
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| contact_infos | object | no |  |
| third_account | object | no |  |
| title | string | no |  |
| content | array | no |  |
| columns | object | no | List columns to display |
| reference | string | no | Free variable not display in document |
| discount | object | no |  |
| currency | string | no |  |
| legal_notice | string | no | Legal mentions |
| bank_details_id | integer | no |  |
| vat_exemption | object | no |  |
| tags | array | no |  |
| metadata | array | no |  |
| downpayments | array | no |  |
| downpayment_cash | integer | no |  |
| avoid_of | integer | no |  |
| delivered_at | string | no |  |
| payment_period | integer | no | Days count before considere this invoice as late |
| payment_methods | string | no | Accepted methods of payment for this invoice. Methods comma separated |
| number_from_other_software | string | no | Invoices imported from another software are not counted in the numbering and are not locked |

### Create or update many invoices
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| data | array | yes | List of invoices. With ID for update, without for insert |

### Delete many invoices
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-batch-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| ids | array | yes | List of invoices ID |

### Download a list of invoices in pdf into a .zip file
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-download` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| ids | array | yes | Array of invoices id |
| template | string | no | Template name to generate document |

### Regenerate pdf and recalcul amounts of invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-fresh` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| ids | array | yes | Array of invoices id |

### Get the next invoice number for preview
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-nextnumber` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| written_at | string | no | Write date |

### Obtain statistics about invoices
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |

### Get an invoice
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of invoice |

### Update an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of invoice |
| contact_infos | object | no |  |
| third_account | object | no |  |
| title | string | no |  |
| content | array | no |  |
| columns | object | no | List columns to display |
| reference | string | no | Free variable not display in document |
| discount | object | no |  |
| currency | string | no |  |
| legal_notice | string | no | Legal mentions |
| bank_details_id | integer | no |  |
| vat_exemption | object | no |  |
| tags | array | no |  |
| metadata | array | no |  |
| downpayments | array | no |  |
| downpayment_cash | integer | no |  |
| avoid_of | integer | no |  |
| delivered_at | string | no |  |
| payment_period | integer | no | Days count before considere this invoice as late |
| payment_methods | string | no | Accepted methods of payment for this invoice. Methods comma separated |

### Remove an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of invoice |

### Attach a file at an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-attach` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes |  |
| file | string | no | File to attach |

### Detach a file at an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-detach` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id |
| file_id | integer | no | File to detach |

### Create a creditnote on an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-avoid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id to create a credit note |

### Duplicate an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-duplicate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id to duplicate |

### Finalize an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-finalize` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id to finalize |
| force_date | boolean | no | Automatically updates the date if earlier than the last invoice |

### Download the invoice as pdf
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-pdf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id to download |
| template | string | no | Template name to generate document |

### Download invoice as jpeg
`GET https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-preview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id to download |
| template | string | no | Template name to generate document |
| disable_cache | boolean | no | Force the regeneration of the preview |
| base64 | boolean | no | Get the image in base64 |

### Add a tag on an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id |
| tag | string | no | Tag to add |

### Delete a tag on an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-untag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id |
| tag | string | no | Tag to delete |

### Update the status of an invoice
`POST https://www.apizie.tech/v1/finance:sinao/app-documents-sales-invoices-updatestatus` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | Invoice id |
| status | string | no | Status to update |

### List autoreconciliation logs
`GET https://www.apizie.tech/v1/finance:sinao/app-cashflow-logsautoreconciliations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Start force autoreconciliation
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-logsautoreconciliations-start` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Clear autoreconciliation logs
`POST https://www.apizie.tech/v1/finance:sinao/app-cashflow-logsautoreconciliations-clear` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Get the import state of Stripe data
`GET https://www.apizie.tech/v1/finance:sinao/app-openai-billings-estimate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| description | string | yes |  |

### Get organization profile for current app
`GET https://www.apizie.tech/v1/finance:sinao/app-organization-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Update organization profile for current app
`POST https://www.apizie.tech/v1/finance:sinao/app-organization-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | no | Company name visible on the app |
| billing_name | string | no | Company name for billing |
| logo | string | no |  |
| legal_form | string | no |  |
| country_iso2 | string | no |  |
| founding_date | string | no |  |
| founding_location | string | no |  |
| dissolution_date | string | no |  |
| closeaccounting_period | string | no |  |
| national_id | string | no | Unique National Id, format by country. **In France : [0-9]{9} with last number as security key.** |
| trade_directory_registration | string | no | France Directory Registration : Unique national ID SIRET [0-9]{9} + 'RM' + CMA identification number [0-9a-z]{2,} |
| vat_id | string | no | European VAT Id. **In France : FR [0-9]{2} [0-9]{9}** |
| code_naf | string | no | French NAF Code |
| number_of_employees | string | no |  |
| industry | string | no |  |
| slogan | string | no |  |
| rcs | string | no | French. Registre du Commerce et des Sociétés |
| greffe | string | no | French. Tribunal de commerce |
| sap_number_registration | string | no | NOVA agreement/registration number |
| sap_activities | string | no | Organisation activities displayed in annual taxes customer attestation |
| sap_date_registration | string | no | NOVA agreement/registration date |
| capital | integer | no |  |

### List organizations
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create an organization
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | yes | Company name visible on the app |
| billing_name | string | no | Company name for billing |
| logo | string | no |  |
| legal_form | string | no |  |
| country_iso2 | string | no |  |
| founding_date | string | no |  |
| founding_location | string | no |  |
| dissolution_date | string | no |  |
| vat_system | string | no |  |
| closeaccounting_period | string | no |  |
| national_id | string | no | Unique National Id, format by country. **In France : [0-9]{9} with last number as security key.** |
| vat_id | string | no | European VAT Id. **In France : FR [0-9]{2} [0-9]{9}** |
| code_naf | string | no | French NAF Code |
| number_of_employees | string | no |  |
| slogan | string | no |  |
| rcs | string | no | French. Registre du Commerce et des Sociétés |
| greffe | string | no | French. Tribunal de commerce |
| capital | integer | no |  |
| metadata | array | no |  |

### Create multiple organizations
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| data | array | yes | List of invoices. With ID for update, without for insert |

### Get an organization
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of organization |

### Update an organization
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of organization |
| name | string | no | Company name visible on the app |
| billing_name | string | no | Company name for billing |
| logo | string | no |  |
| legal_form | string | no |  |
| country_iso2 | string | no |  |
| founding_date | string | no |  |
| founding_location | string | no |  |
| dissolution_date | string | no |  |
| vat_system | string | no |  |
| closeaccounting_period | string | no |  |
| national_id | string | no | Unique National Id, format by country. **In France : [0-9]{9} with last number as security key.** |
| vat_id | string | no | European VAT Id. **In France : FR [0-9]{2} [0-9]{9}** |
| code_naf | string | no | French NAF Code |
| number_of_employees | string | no |  |
| slogan | string | no |  |
| rcs | string | no | French. Registre du Commerce et des Sociétés |
| greffe | string | no | French. Tribunal de commerce |
| capital | integer | no |  |
| metadata | array | no |  |

### Remove an organization
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of organization |

### Restore an organization
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-organizations-restore` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of organization |

### List payments
`GET https://www.apizie.tech/v1/finance:sinao/app-payments-payments-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Get the recipe book
`GET https://www.apizie.tech/v1/finance:sinao/app-payments-payments-recipe-book` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### Get a payment
`GET https://www.apizie.tech/v1/finance:sinao/app-payments-payments-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of payment |

### Remove a payment
`POST https://www.apizie.tech/v1/finance:sinao/app-payments-payments-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of quote |

### List persons
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a person
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| civility | string | no | Civility is the lastname prefix |
| lastname | string | yes |  |
| firstname | string | no |  |
| picture | string | no |  |
| metadata | array | no |  |

### Create multiple persons
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| data | array | yes | List of persons. With ID for update, without for insert |

### Get a person
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of a person |

### Update a person
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of a person |
| civility | string | no | Civility is the lastname prefix |
| lastname | string | no |  |
| firstname | string | no |  |
| picture | string | no |  |
| metadata | array | no |  |

### Remove a person
`POST https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of person |

### Restore a person
`GET https://www.apizie.tech/v1/finance:sinao/app-contacts-persons-restore` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of a person |

### Ping app web hostname
`GET https://www.apizie.tech/v1/finance:sinao/app-ping` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |

### List product categories
`GET https://www.apizie.tech/v1/finance:sinao/app-catalog-categories-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| offset | integer | no | The number of items to skip before starting to collect the result set. |
| limit | integer | no | The numbers of items to return. |
| search | string | no | A string to search for in objects. |
| filters | array | no | List of filters to apply to the query. |
| order | array | no | List in order of priority of the variables by which to order the result. |

### Create a product category
`POST https://www.apizie.tech/v1/finance:sinao/app-catalog-categories-create` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| name | string | yes |  |
| image | string | no |  |
| parent_category_id | integer | no |  |

### Get a product category
`GET https://www.apizie.tech/v1/finance:sinao/app-catalog-categories-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of product category |

### Update a product category
`POST https://www.apizie.tech/v1/finance:sinao/app-catalog-categories-update` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | integer | yes | The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have… |
| id | integer | yes | ID of product category |
| name | string | yes |  |
| image | string | no |  |
| parent_category_id | integer | no |  |

…and 161 more. See the OpenAPI spec.

## Example
```
curl "https://www.apizie.tech/v1/finance:sinao/app-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

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

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

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