Improved
🔄 Freshness filters & full-source employments
7 days ago by ReadMe API
- New optional
updated_at_from/updated_at_toquery params and a per-rowupdated_attimestamp onGET /invoices— filter invoices by freshness. - New the same
updated_at_from/updated_at_tofiltering and per-rowupdated_atonGET /employments. - 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 /invoices
updated_at range filtering on GET /invoicesGET /invoicesnow 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 invoice 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.
updated_at range filtering on GET /employments
updated_at range filtering on GET /employmentsGET /employmentsaccepts the same optionalupdated_at_from/updated_at_toparams, with identical semantics.- Each employment row now carries its own
updated_atreflecting the real recovery date of that record.
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.
