Skip to main content
GET
/
api
/
v1
/
lookups
/
taxes
Get Tax Types
curl --request GET \
  --url https://api.example.com/api/v1/lookups/taxes \
  --header 'Authorization: <authorization>' \
  --header 'X-Factus-Token: <x-factus-token>'
{
  "400": {},
  "401": {},
  "success": true,
  "message": "<string>",
  "data": [
    {
      "id": 123,
      "name": "<string>",
      "code": "<string>",
      "description": "<string>"
    }
  ],
  "errors": "<any>"
}

​
Overview

This endpoint returns a list of tax types that can be applied to products in electronic invoices. Each tax type includes its identifier, name, code, and optional description.

​
Authentication

This endpoint requires both Bearer token authentication and a Factus API token.
​
Authorization
string
required
Bearer token for API authenticationFormat: Bearer <your_access_token>
​
X-Factus-Token
string
required
Your Factus API token for accessing the e-invoicing platform

​
Response

Returns a standardized API response containing an array of tax type objects.
​
success
boolean
Indicates if the request was successful
​
message
string
Human-readable message about the operation result
​
data
array
Array of tax type objects
​
id
integer
Unique identifier for the tax type
​
name
string
Name of the tax type
​
code
string
Official tax type code
​
description
string
Optional detailed description of the tax type
​
errors
any
default:"null"
Error details if the request failed

​
Example Request

cURL
curl --request GET \
  --url https://api.yourapp.com/api/v1/lookups/taxes \
  --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
  --header 'X-Factus-Token: your_factus_token_here'

​
Example Response

200 - Success
{
  "success": true,
  "message": "Tipos de impuesto obtenidos exitosamente",
  "data": [
    {
      "id": 1,
      "name": "IVA",
      "code": "01",
      "description": "Impuesto al Valor Agregado"
    },
    {
      "id": 2,
      "name": "INC",
      "code": "04",
      "description": "Impuesto Nacional al Consumo"
    },
    {
      "id": 3,
      "name": "ICA",
      "code": "03",
      "description": "Impuesto de Industria y Comercio"
    },
    {
      "id": 4,
      "name": "No Causa",
      "code": "ZZ",
      "description": null
    }
  ],
  "errors": null
}
400 - Bad Request
{
  "detail": "Error al obtener datos de Factus: Invalid token"
}
401 - Unauthorized
{
  "detail": "Not authenticated"
}

​
Error Responses

​
400
Bad Request
Invalid request or error communicating with Factus API. Check the detail field for specific error information.
​
401
Unauthorized
Missing or invalid authentication credentials. Ensure both Authorization header and X-Factus-Token are provided.

Build docs developers (and LLMs) love

Get started for freeTalk to us