List all employments

GET {{baseUrl}}/api/co/employments/?link=8848bd0c-9c7e-4f53-a732-ec896b11d4c4

Get a paginated list of all existing employments in your Belvo account. By default, we return up to 100 results per page.

Request Params

| Key | Datatype | Required | Description | | link | string | | (Required) The link.id you want to filter by.

ℹ️ We highly recommend adding the link.id filter in order to improve your performance. | | link__in | string | | Return results only for these link.ids. | | id | string | | Return information only for this resource id. | | id__in | string | | Return information for these resource ids. | | page | number | | A page number within the paginated result set. | | page_size | number | | Indicates how many results to return per page. By default we return 100 results per page.

ℹ️ The minimum number of results returned per page is 1 and the maximum is 1000. If you enter a value greater than 1000, our API will default to the maximum value (1000). | | omit | string | | Omit certain fields from being returned in the response. For more information, see our Filtering responses DevPortal article. | | fields | string | | Return only the specified fields in the response. For more information, see our Filtering responses DevPortal article. | | created_at | string | | Return items that were last updated in Belvo's database on this date (in YYYY-MM-DD format). | | created_at__gt | string | | Return items that were last updated in Belvo's database after this date (in YYYY-MM-DD format). | | created_at__gte | string | | Return items that were last updated in Belvo's database after or on this date (in YYYY-MM-DD format). | | created_at__lt | string | | Return items that were last updated in Belvo's database before this date (in YYYY-MM-DD format). | | created_at__lte | string | | Return items that were last updated in Belvo's database before or on this date (in YYYY-MM-DD format). | | created_at__range | string | | Return accounts that were last updated in Belvo's database between two dates (in YYYY-MM-DD format). |

HEADERS

| Key | Datatype | Required | Description | | Accept | string | | |

RESPONSES

status: OK

{"count":130,"next":"https://nmkk.royqOlBvdOW.y","previous":null,"results":[{"id":"2ccd5e15-194a-4a19-a45a-e7223c7e6717","link":"2ccd5e15-194a-4a19-a45a-e7223c7e6717","created_at":"2020-04-23T21:32:55.336854+00:00","collected_at":"2020-04-23T21:32:55.336854+00:00","employer_data":{"name":"Campari Bebidas","id_type":"NIT","id_number":7351890246,"economic_activity_code":6020,"economic_activity_code_description":"ACTIVIDADES DE PROGRAMACIÓN Y TRANSMISIÓN DE TELEVISIÓN","contributor_class_code":"A","contributor_class_code_description":"EMPRESAS CON MAS DE 200 COTIZANTES","contributor_type_code":32,"contributor_type_description":"Pagador Programa de Reincorporación","tenure":8},"salary_and_benefit_details":[{"month":"2022-01","gross_amount":12000000,"net_amount":9500000,"employment_type":"SALARIED","employment_type_additional_info":"Cotizante miembro de la carrera diplomática o consular de un país extranjero o funcionario de organismo multilateral","parafiscal_contribution":true,"salary_comprehensive":true,"salary_type":"FIXED","pension_fund_name":"S.O.S. SERVICIO OCCIDENTAL DE SALUD S.A.","healthcare_provider_name":"SKANDIA ALTERNATIVO","status_changes":["FIRST_MONTH","PERMANENT_SALARY_CHANGE"]},{"month":"2022-01","gross_amount":12000000,"net_amount":9500000,"employment_type":"SALARIED","employment_type_additional_info":"Cotizante miembro de la carrera diplomática o consular de un país extranjero o funcionario de organismo multilateral","parafiscal_contribution":true,"salary_comprehensive":true,"salary_type":"FIXED","pension_fund_name":"S.O.S. SERVICIO OCCIDENTAL DE SALUD S.A.","healthcare_provider_name":"SKANDIA ALTERNATIVO","status_changes":["FIRST_MONTH","PERMANENT_SALARY_CHANGE"]}]},{"id":"2ccd5e15-194a-4a19-a45a-e7223c7e6717","link":"2ccd5e15-194a-4a19-a45a-e7223c7e6717","created_at":"2020-04-23T21:32:55.336854+00:00","collected_at":"2020-04-23T21:32:55.336854+00:00","employer_data":{"name":"Campari Bebidas","id_type":"NIT","id_number":7351890246,"economic_activity_code":6020,"economic_activity_code_description":"ACTIVIDADES DE PROGRAMACIÓN Y TRANSMISIÓN DE TELEVISIÓN","contributor_class_code":"A","contributor_class_code_description":"EMPRESAS CON MAS DE 200 COTIZANTES","contributor_type_code":32,"contributor_type_description":"Pagador Programa de Reincorporación","tenure":8},"salary_and_benefit_details":[{"month":"2022-01","gross_amount":12000000,"net_amount":9500000,"employment_type":"SALARIED","employment_type_additional_info":"Cotizante miembro de la carrera diplomática o consular de un país extranjero o funcionario de organismo multilateral","parafiscal_contribution":true,"salary_comprehensive":true,"salary_type":"FIXED","pension_fund_name":"S.O.S. SERVICIO OCCIDENTAL DE SALUD S.A.","healthcare_provider_name":"SKANDIA ALTERNATIVO","status_changes":["FIRST_MONTH","PERMANENT_SALARY_CHANGE"]},{"month":"2022-01","gross_amount":12000000,"net_amount":9500000,"employment_type":"SALARIED","employment_type_additional_info":"Cotizante miembro de la carrera diplomática o consular de un país extranjero o funcionario de organismo multilateral","parafiscal_contribution":true,"salary_comprehensive":true,"salary_type":"FIXED","pension_fund_name":"S.O.S. SERVICIO OCCIDENTAL DE SALUD S.A.","healthcare_provider_name":"SKANDIA ALTERNATIVO","status_changes":["FIRST_MONTH","PERMANENT_SALARY_CHANGE"]}]}]}