Improved
🔄 Employments: freshness filters & full-source records
about 1 month ago by ReadMe API
- New optional
updated_at_from/updated_at_toquery params and a per-rowupdated_attimestamp onGET /employments— filter employment records by freshness. - Improved
GET /employmentsnow returns records from all IMSS/ISSSTE sources (no more static priority dedup); distinguish them viadata_source.
⚙️ What Changes
updated_at range filtering on GET /employments
updated_at range filtering on GET /employmentsGET /employmentsnow accepts optionalupdated_at_fromandupdated_at_toquery params (formatYYYY-MM-DD, e.g.?updated_at_from=2026-01-01&updated_at_to=2026-03-31). Both are optional and combinable (from-only, to-only, or a full range).- Each employment row now carries its own
updated_at(ISO-8601) reflecting the real recovery date of that record. from > toreturns a400invalid_input_dataerror; equal bounds are allowed.
GET /employments returns all data sources
GET /employments returns all data sources- The endpoint no longer collapses each institution to a single "winning" source. It returns records from every IMSS/ISSSTE source (
imss_get_weeks,imss_rpci,issste, …), and clients distinguish them via thedata_sourcefield. - Responses may now include more rows and pagination counts may grow accordingly. Existing response contracts are otherwise unchanged.
🛠️ No Action Required
The new query params and fields are additive and optional. GET /employments returning more rows is the main behavioral change — use the data_source field to filter by source if you previously relied on the server picking one for you.
