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

KeyDatatypeRequiredDescription
linkstring(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

KeyDatatypeRequiredDescription
Acceptstring

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"]}]}]}