# Update Social Security Report Updates the quarterly self-report for year and quarter. PATCH is routed to the same action and behaves identically. Send only the fields to change, wrapped in a social_security_report key; the response always returns all five. year and quarter in the body are silently ignored, the URL identifies the report; there is no way to move a report to another quarter, and no DELETE (reports are removed only by DELETE /api/v3/accounts/social_security). reported_at and submitted_at of that quarter on the quarterly declaration endpoints are synced when a report is created or updated (deleting the settings does not clear submitted_at): setting or changing reported_at sets submitted_at to it, null clears submitted_at, and a change to only estimated_monthly_payment or monthly_payment leaves it untouched. Exception: for year 9999 with quarter 4, setting reported_at answers 500 and saves nothing. 422 (no NISS) is checked before 404 (no report for that quarter, or a URL segment that is not purely digits). Requires the administrator or contributor role. Error messages follow the language of the account (pt, en or es), not the Accept-Language header. JSON only. This feature only calculates and records; it submits nothing to Segurança Social. Endpoint: PUT /api/v3/accounts/social_security_reports/{year}/{quarter} Version: 3.1.0 Security: apiKeyAuth ## Path parameters: - `year` (integer, required) Year of the quarterly self-report, digits only (for example 2026). A segment that is not purely digits (such as 2026abc) answers 404, as does a year with no report. Example: 2026 - `quarter` (integer, required) Quarter of the self-report, 1 to 4, digits only. A segment that is not purely digits answers 404, as does a quarter with no report (including 0 and 5 or more). Example: 2 ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `social_security_report` (object, required) - `social_security_report.reported_at` (string,null) A new value sets submitted_at of the quarter to it; null clears it. Omitted or unchanged leaves it untouched. Example: "2026-08-01T10:00:00Z" - `social_security_report.estimated_monthly_payment` (number,string,null) 0 to 9999999999.99. null clears it. Example: 53.53 - `social_security_report.monthly_payment` (number,string,null) 0 to 9999999999.99. null clears it. Example: 60.46 ## Response 200 fields (application/json): - `social_security_report` (object) A quarterly self-report, identified by year + quarter (there is no id). At most one per account, year and quarter. A personal tracking record; nothing is sent to Segurança Social. - `social_security_report.year` (integer) Year of the report. Set on create; ignored on update. Supported range 1583 to 9999, as on the quarterly declaration endpoints, except year 9999 with quarter 4 when reported_at is set (500, nothing is saved); the API does not validate it, and a value outside the range may answer 500. Example: 2026 - `social_security_report.quarter` (integer) Quarter, 1 to 4. Set on create; ignored on update. Example: 2 - `social_security_report.reported_at` (string,null) When the quarter was declared in Segurança Social Direta, null when not set. Returned as ISO 8601 in the account's time zone (for example +01:00), whatever offset was sent. Setting, changing or clearing it also sets or clears submitted_at of that quarter on the quarterly declaration endpoints. Example: "2026-07-15T20:08:03+01:00" - `social_security_report.estimated_monthly_payment` (string,null) The monthly payment that was estimated, as a decimal string (not a number), 0 to 9999999999.99, rounded to 2 places, in the shortest form but always with at least one decimal digit ("53.53", "55.1", "70.0"). null when not set. Example: "53.53" - `social_security_report.monthly_payment` (string,null) The monthly payment actually charged, as a decimal string (not a number), 0 to 9999999999.99, rounded to 2 places, in the shortest form but always with at least one decimal digit ("53.53", "55.1", "70.0"). null when not set. Example: "55.1" ## Response 400 fields (application/json): - `errors` (array) Example: [{"error":"No NISS is set for this account yet."}] - `errors.error` (string) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 403 fields (application/json): - `errors` (array) Example: [{"error":"You do not have permission to perform this action"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"No NISS is set for this account yet."}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"No NISS is set for this account yet."}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)