API Reference

/contrato-paginado/

Servicio que permite obtener los contratos de los trabajadores y sus condiciones contractuales de forma paginada para altos volúmenes de datos.
Muestra los contratos y condiciones activas al día de hoy de forma individual.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

1.El endpoint contrato-paginado retorna los contratos de colaboradores que se encuentran vigentes a la fecha de ejecución de la consulta.

Si se requiere obtener la información de los colaboradores vigentes al cierre de un período determinado —replicando el comportamiento de la vista Empleados del SaaS— la consulta debe incluir los siguientes parámetros:

  • search_since
  • search_to
  • type_status_search=actives

Nota: La combinación de estos parámetros filtra los contratos activos dentro del rango de fechas indicado, alineando el resultado con la lógica de cierre de período utilizada por el sistema.


  1. Para consultar los trabajadores finiquitados en un período específico, debe utilizar el filtro show=all antes de usar los parámetros "terminated". Esto permite mostrar contratos no activos.
    Ejemplo de curl: https://talana.com/es/api/contrato-paginado/?show=all&terminated_since=20260301&terminated_to=20260331&
Query Params
integer

A page number within the paginated result set.

integer

Number of results to return per page.

string
enum

Parámetro que permite mostrar todas las versiones de contratos (vigentes y no vigentes)

Allowed:
string
enum
Defaults to actives

Tipo de búsqueda por estado de contratos

Allowed:
string
enum

Mostrar una version específica del contrato

Allowed:
date

Contratos activos en una fecha específica (YYYYMMDD)

date

Fecha de inicio para búsqueda por rango (YYYYMMDD)

date

Fecha de fin para búsqueda por rango (YYYYMMDD)

date

Contratos creados desde esta fecha (YYYYMMDD)

date

Contratos creados hasta esta fecha (YYYYMMDD)

date

Contratos con fecha de contratación desde (YYYYMMDD)

date

Contratos con fecha de contratación hasta (YYYYMMDD)

date

Contratos finiquitados desde esta fecha (YYYYMMDD)

date

Contratos finiquitados hasta esta fecha (YYYYMMDD)

string

Alias para modificado_desde (YYYY-MM-DD o YYYYMMDD)

string

Alias para modificado_hasta (YYYY-MM-DD o YYYYMMDD)

string
^\d{7,8}-[\dkK]$

RUT del empleado (formato chileno: 12345678-9)

integer

ID del centro de costo

string

Código específico del contrato

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/javascript