# Fonoa API Documentation > Documentation for Fonoa API ## API Reference: Introduction - [Getting Started with Fonoa API](https://docs.fonoa.com/reference/getting-started-with-fonoa-api.md) - [Environments](https://docs.fonoa.com/reference/environments.md) - [API Authentication Overview](https://docs.fonoa.com/reference/api-authentication-overview.md) ## API Reference: Details & Concepts - [Authentication](https://docs.fonoa.com/reference/authentication.md) - [Webhooks](https://docs.fonoa.com/reference/webhooks.md) - [Sandbox environment](https://docs.fonoa.com/reference/sandbox-environment.md) ## API Reference: Fonoa Lookup - [Request a validation](https://docs.fonoa.com/reference/requestavalidationv2-1.md): This endpoint allows you to request a validation of the Tax Identification Number. In order to do so, our system needs a country of the client (ISO code) and a tax identification number of the… - [Get result of validation](https://docs.fonoa.com/reference/getresultofvalidationv2-1.md): This endpoint provides Tax Identification Number validation results. To access it you need to use the validation_id returned from the “Request a validation” endpoint. It consists of a validation… - [Delete result of validation](https://docs.fonoa.com/reference/deleteresultofvalidationv2-1.md): This endpoint allows the deletion of a single validation. That validations must be finished (not running) and can not be part of a validations batch. If you want to delete a validation the belongs… - [Request a batch validation](https://docs.fonoa.com/reference/requestbatchvalidationv2-1.md): This endpoint allows you to request a batch of TINs to be validated. In order to do so, our system needs a country where relevant TINs are registered (ISO code) and the TIN data. You can have… - [Get result of batch validation](https://docs.fonoa.com/reference/getresultofbatchvalidationv2-1.md): This endpoint provides batch Tax Identification Number validation results. To access it you need to use the batch_id returned from the “Request a batch validation” endpoint. It consists of a… - [Delete all validations that belong to the batch](https://docs.fonoa.com/reference/deletebatchofvalidationsv2-1.md): This endpoint allows the deletion of a batch resource and all its validations. All validations in the batch must be finished (not running) for it to get deleted. - [Cancel running Batch Validation](https://docs.fonoa.com/reference/cancelbatchvalidationv2-1.md): This endpoint allows you to cancel running batch validation. - [Request a TIN search](https://docs.fonoa.com/reference/requesttinsearch.md): This endpoint allows you to search for a business or entity by name within a given country. The system returns a list of matching results, each enriched with tax registration details. - [Get TIN search results](https://docs.fonoa.com/reference/gettinsearchresult.md): This endpoint returns the results of a previously submitted TIN search request. The `status` field indicates whether processing is complete: - **"running"** — the search is still in progress; poll… - [Instant Lookup](https://docs.fonoa.com/reference/instant-lookup.md) - [Find a tax identification number](https://docs.fonoa.com/reference/findtin-1.md): This endpoint allows you to request a validation of the Tax Identification Number and get the response instantly. In order to do so, our system needs a country of the client (ISO code) and a tax… - [Request a validation](https://docs.fonoa.com/reference/requestavalidation-1.md): This endpoint allows you to request a validation of the Tax Identification Number. In order to do so, our system needs a country of the client (ISO code) and a tax identification number of the client. - [Get result of validation](https://docs.fonoa.com/reference/getresultofvalidation-1.md): This endpoint provides Tax Identification Number validation results. To access it you need to use an ID returned from the “Request a validation” endpoint. It consists of a validation results and… - [Request a batch validation](https://docs.fonoa.com/reference/requestbatchvalidation-1.md): This endpoint allows you to request a batch of TINs to be validated. In order to do so, our system needs a country where relevant TINs are registered (ISO code) and the TIN data. You can have… - [Get result of batch validation](https://docs.fonoa.com/reference/getresultofbatchvalidation-1.md): This endpoint provides batch Tax Identification Number validation results. To access it you need to use the batch_id returned from the “Request a batch validation” endpoint. It consists of a… - [Cancel running Batch Validation](https://docs.fonoa.com/reference/cancelbatchvalidation-1.md): This endpoint allows you to cancel running batch validation. - [Lookup sandbox environment](https://docs.fonoa.com/reference/lookup-sandbox-environment.md) ## API Reference: Fonoa Tax - [Request a Calculation](https://docs.fonoa.com/reference/request-a-calculation.md) - [View a Calculation](https://docs.fonoa.com/reference/view-a-calculation.md) - [Update a Calculation](https://docs.fonoa.com/reference/commit-a-calculation.md) - [Request a calculation](https://docs.fonoa.com/reference/requestataxrate-1.md): In the one example, you can see a tax determination for a service provided directly to a consumer not through a marketplace. The other example shows a tax determination for a transaction that takes… ## API Reference: Fonoa E-invoicing - [About Fonoa E-Invoicing](https://docs.fonoa.com/reference/about-fonoa-e-invoicing.md) - [Quickstart](https://docs.fonoa.com/reference/quickstart.md) - [Amounts and rounding](https://docs.fonoa.com/reference/amounts-and-rounding.md) - [Submit a transaction](https://docs.fonoa.com/reference/submit-a-transaction.md) - [Get the result](https://docs.fonoa.com/reference/get-the-result.md) - [Onboarding](https://docs.fonoa.com/reference/onboarding-v2.md): Onboarding the various transaction participants - [Transaction with Discount](https://docs.fonoa.com/reference/transaction-with-discount.md) - [Transaction with Fee](https://docs.fonoa.com/reference/transaction-with-fee.md) - [Adjust a transaction](https://docs.fonoa.com/reference/adjust-a-transaction.md) - [Credit a transaction](https://docs.fonoa.com/reference/credit-a-transaction.md) - [Credit multiple transactions](https://docs.fonoa.com/reference/credit-multiple-transactions.md): Issue a credit note referencing multiple invoices - [Backfill transactions](https://docs.fonoa.com/reference/backfill-transactions.md) - [Cancel a transaction](https://docs.fonoa.com/reference/cancel-a-transaction.md) - [Submit a transaction](https://docs.fonoa.com/reference/post_v1-transactions.md): Submit a transaction to fulfill digital reporting requirements. Depending on the configuration one or more operations may be executed - [Get a list of transactions](https://docs.fonoa.com/reference/get_v1-transactions.md): Used to search for transactions. - [Get a transaction](https://docs.fonoa.com/reference/get_v1-transactions-operation-id.md): Get a previously submitted transaction referenced by Fonoa ID. There are no guarantees that the transaction will be available before the transaction_completed webhook is sent. - [Get transaction history](https://docs.fonoa.com/reference/get_v1-transactions-history-transaction-id.md): Get a list of all operations for the given transaction id along with a status (in progress, failed, completed) for each operation - [Adjust a transaction](https://docs.fonoa.com/reference/post_v1-transactions-adjustment.md): Create an adjustment for a previously submitted transaction. Adjustment (also known as partial credit note) must reference the original transaction. Use /adjustment endpoint for credit a subset of… - [Cancel a transaction](https://docs.fonoa.com/reference/post_v1-transactions-cancellation.md): Cancel a previously submitted transaction. Cancellation must reference the transaction you want to cancel. It can be the original transaction, a credit note or an adjustment. Use /cancellation… - [Credit a transaction](https://docs.fonoa.com/reference/post_v1-transactions-credit.md): Credit a previously submitted transaction. Credit note must reference the original debit transaction. Use /credit endpoint to credit the whole transaction. - [Onboarding](https://docs.fonoa.com/reference/onboarding.md) - [Onboard a company](https://docs.fonoa.com/reference/post_onboarding-v2-companies.md): Each transaction consists of at least two parties: Supplier and Customer. In most cases, the Supplier will be a company. On the other side of the transaction, the Customer can be an individual (B2C… - [Get company details](https://docs.fonoa.com/reference/get_onboarding-v2-companies-id.md): Used to retrieve details for a successfully onboarded company. - [Get a list companies](https://docs.fonoa.com/reference/get_onboarding-v2-companies.md): Used to search for successfully onboarded companies. - [Update a company](https://docs.fonoa.com/reference/put_onboarding-v2-companies-id.md): This Company update endpoint allows you to modify companies previously onboarded. This endpoint replaces all the existing company details with the new ones provided in the request body. The… - [Update company details](https://docs.fonoa.com/reference/patch_onboarding-v2-companies-id.md): Used to update details for an existing onboarded company. Only the fields listed here are available to update - [Delete a company](https://docs.fonoa.com/reference/delete_onboarding-v2-companies-id.md): Used to delete an onboarded company. DELETE operations are synchronous, contrary to POST ones. - [Document Templates](https://docs.fonoa.com/reference/custom-document-templates.md) - [List document templates](https://docs.fonoa.com/reference/get_onboarding-v2-templates.md): List custom document templates, optionally filtered by status. - [Create a document template for PDFs](https://docs.fonoa.com/reference/post_onboarding-v2-templates.md): Create a custom HTML document template (such as an invoice PDF layout). - [Delete a document template](https://docs.fonoa.com/reference/delete_onboarding-v2-templates-id.md): Delete a document template. Fails if the document template is referenced by a configuration. - [Get document template details](https://docs.fonoa.com/reference/get_onboarding-v2-templates-id.md): Retrieve document template metadata and optionally a presigned URL for the HTML content. - [Update document template details](https://docs.fonoa.com/reference/patch_onboarding-v2-templates-id.md): Update document template metadata and/or HTML content. Only the fields listed here are available to update. - [List document template configurations](https://docs.fonoa.com/reference/get_onboarding-v2-templates-configurations.md): List document template configurations, optionally filtered by country code. - [Configure document template](https://docs.fonoa.com/reference/post_onboarding-v2-templates-template-id-configure.md): Configure a document template for a country, document type, and business model combination. - [Delete document template configuration](https://docs.fonoa.com/reference/delete_onboarding-v2-templates-configurations-id.md): Remove a document template configuration. - [Errors, Warnings and how to handle them](https://docs.fonoa.com/reference/errors-warnings-and-how-to-handle-them.md)