Search SAT Products

GET /api/sat/search

Searches the SAT (Servicio de Administración Tributaria) product and service catalog with filtering and pagination. Returns products/services matching the search criteria.

Authentication

This endpoint requires authentication. Include your access token in the request cookies.

Query Parameters

string

Search term to find products/services by description or keywords

string

Filter by IVA requirement. Options: Sí, No, Opcional

string

Filter by IEPS requirement. Options: Sí, No, Opcional

number

default:"20"

Number of results per page (1-100)

number

default:"0"

Number of results to skip for pagination

Response

SATProductServiceAttributes[]

required

Array of SAT product/service objects

Show Product/Service Object

string

required

SAT product/service code (e.g., “80141600”)

string

required

Description of the product or service

string

required

IVA requirement. Options: Sí, No, Opcional

string

required

IEPS requirement. Options: Sí, No, Opcional

string

Required complement for invoicing. Null if none required

string

required

Start date of validity (ISO 8601 format)

string

End date of validity (ISO 8601 format). Null if still valid

string

required

Border zone stimulus information

string

Similar keywords for search optimization. Null if none

string

required

Record creation timestamp

string

required

Record last update timestamp

number

required

Total number of results matching the query

number

required

Number of items returned in this response

number

required

Offset used for this query

Example Request

curl -X GET "https://api.contafy.com/api/sat/search?query=consultoría&limit=10&offset=0" \
  -H "Cookie: access_token=your_access_token"

Example Response

{
  "items": [
    {
      "id": "80141600",
      "descripcion": "Servicios de consultoría de negocios y administración corporativa",
      "incluir_iva_trasladado": "Sí",
      "incluir_ieps_trasladado": "No",
      "complemento_que_debe_incluir": null,
      "fecha_inicio_vigencia": "2017-01-01T00:00:00Z",
      "fecha_fin_vigencia": null,
      "estimulo_franja_fronteriza": "No aplica",
      "palabras_similares": "consultoría empresarial asesoría negocios",
      "created_at": "2023-01-15T10:00:00Z",
      "updated_at": "2023-01-15T10:00:00Z"
    },
    {
      "id": "80141601",
      "descripcion": "Servicios de consultoría en administración de recursos humanos",
      "incluir_iva_trasladado": "Sí",
      "incluir_ieps_trasladado": "No",
      "complemento_que_debe_incluir": null,
      "fecha_inicio_vigencia": "2017-01-01T00:00:00Z",
      "fecha_fin_vigencia": null,
      "estimulo_franja_fronteriza": "No aplica",
      "palabras_similares": "recursos humanos rrhh personal",
      "created_at": "2023-01-15T10:00:00Z",
      "updated_at": "2023-01-15T10:00:00Z"
    }
  ],
  "total": 45,
  "limit": 10,
  "offset": 0
}

Error Responses

error

Authentication required or token expired

{
  "error": "Unauthorized",
  "message": "Authentication required"
}

error

Invalid query parameters

{
  "error": "Bad Request",
  "message": "Invalid limit. Must be between 1 and 100"
}

error

Rate limit exceeded based on plan limits

{
  "error": "Too Many Requests",
  "message": "SAT search limit exceeded for your plan"
}

error

Server error occurred

{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}

Search limits vary by subscription plan. Check your plan’s satBasicSearchesPerMonth limit.

Authentication

Profiles

Invoices

Expenses

Subscription

SAT Search

Search SAT Products

GET /api/sat/search

Authentication

Query Parameters

Response

Example Request

Example Response

Error Responses

​GET /api/sat/search

​Authentication

​Query Parameters

​Response

​Example Request

​Example Response

​Error Responses

GET /api/sat/search

Authentication

Query Parameters

Response

Example Request

Example Response

Error Responses