For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Where it lives: in the Spain Public Administration results, at data.employment.labor_check. APIs with dedicated per-product results endpoints return this model directly.
The labor check answers three questions about a person: who they have worked for and when,
what they have contributed month by month, and what that means today — whether they are
currently working, their current work statuses, and a guaranteed minimum net income floor. Use it to
verify employment, gauge income stability and assess risk.
It arrives in the session results under data, and the official TGSS reports the data was read
from travel as attachments, downloadable for your own records.
contribution_base_historylist of objectsRequiredRead-onlyDeprecated
currently_activebooleanOptional
current_work_typeslist of enumsOptional
social_security_daysintegerOptional
contribution_base_by_companylist of objectsOptionalDefaults to []
income_floorobjectOptional
attachmentslist of objectsOptionalDefaults to []
Work relations
One entry per period of the labor life, most recent first: employments, self-employment
stretches, and situations that count for Social Security without being a job (an ongoing
unemployment benefit, paid untaken vacations). The ccc employer account code is the join key
to the contribution history below.
activity_startdateRequired
namestringRequired
work_typeenumRequired
contract_typeenumRequired
work_scheduleenumRequired
Allowed values:
activity_enddateOptional
Activity end date. Empty while the relation is ongoing.
regimestringOptional
Social Security regime of this relation.
cccstringOptional
assimilatedbooleanOptionalDefaults to false
contribution_groupstringOptional
Contribution group of the worker in this relation.
collective_agreementstringOptional
Collective agreement governing this relation, when declared.
social_security_daysintegerOptional
currently_activebooleanOptional
Contribution bases
The monthly contribution history, grouped per employer account — join each group to its work
relation through ccc. The flat contribution_base_history on the labor check is the same
months in one list, for date-keyed consumers.
company_namestringOptional
Employer or regime name, as certified by the TGSS.
cccstringOptional
regimestringOptional
Social Security regime of this account.
is_benefit_blockbooleanOptionalDefaults to false
monthslist of objectsOptionalDefaults to []
Monthly contribution bases of this account, most recent first.
Each month carries its state and, when registered, the gross base:
datedateRequired
yearintegerRequired
Contribution year.
monthintegerRequired
statusenumRequired
baseobjectRequired
provisionalbooleanOptionalDefaults to false
Income floor
The floor is a guaranteed minimum net income, never a salary estimate: deductions are
estimated conservatively so the net stays a floor, and real net income can only be equal or
higher. For self-employed workers it deliberately understates real income — combine it with
other signals.
statusenumRequired
Allowed values:
monthly_floorobjectOptional
annual_floorobjectOptional
The net monthly floor, annualized.
gross_monthly_floorobjectOptional
gross_annual_floorobjectOptional
estimated_deduction_ratestringOptionalformat: "number"Defaults to nan
Decimal number with 4 digits precision
companieslist of objectsOptionalDefaults to []
method_versionstringOptional
Each company contributing to the computed floor appears with its own share — past employments
are never listed here, so nothing in this list can be misread as a salary the person no longer
earns:
company_namestringRequired
Employer or regime this floor comes from.
monthly_floorobjectRequired
annual_floorobjectRequired
Estimated minimum NET annual income from this company.
