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 Search term to find products/services by description or keywords
Filter by IVA requirement. Options: Sí, No, Opcional
Filter by IEPS requirement. Options: Sí, No, Opcional
Number of results per page (1-100)
Number of results to skip for pagination
Response items
SATProductServiceAttributes[]
required
Array of SAT product/service objects Show Product/Service Object
SAT product/service code (e.g., “80141600”)
Description of the product or service
IVA requirement. Options: Sí, No, Opcional
IEPS requirement. Options: Sí, No, Opcional
complemento_que_debe_incluir
Required complement for invoicing. Null if none required
Start date of validity (ISO 8601 format)
End date of validity (ISO 8601 format). Null if still valid
estimulo_franja_fronteriza
Border zone stimulus information
Similar keywords for search optimization. Null if none
Record creation timestamp
Record last update timestamp
Total number of results matching the query
Number of items returned in this response
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 Authentication required or token expired { "error" : "Unauthorized" , "message" : "Authentication required" }
Invalid query parameters { "error" : "Bad Request" , "message" : "Invalid limit. Must be between 1 and 100" }
Rate limit exceeded based on plan limits { "error" : "Too Many Requests" , "message" : "SAT search limit exceeded for your plan" }
500 Internal Server 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.
