# Get Social Security Report Returns the quarterly self-report for year and quarter, wrapped in a social_security_report key. 422 is checked before 404: without a NISS the answer is 422 even for a quarter that never had a report. With a NISS, 404 means no report exists for that quarter (the client can show a create form); it is also the answer when a URL segment is not purely digits (for example /2026abc/2). 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: GET /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" ## 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 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)