# Create Social Security Report Records that the account declared a quarter in Segurança Social Direta, and what it was charged. It is a personal tracking record; nothing is sent anywhere. Send the fields wrapped in a social_security_report key; year (1583 to 9999, except year 9999 with quarter 4 and reported_at set, which answers 500 and saves nothing; the API does not validate it and a value outside the range may answer 500) and quarter (1 to 4) are required and identify the report (there is no id): at most one per account, year and quarter. estimated_monthly_payment and monthly_payment accept 0 to 9999999999.99 and are returned as decimal strings rounded to 2 places, in the shortest form but always with at least one decimal digit ("70.0", "55.1", "53.52"). Setting reported_at also sets submitted_at of that quarter on the quarterly declaration endpoints. The account must already have a NISS (POST /api/v3/accounts/social_security), otherwise the call answers 422. A report cannot be deleted on its own: there is no DELETE; reports are removed only by DELETE /api/v3/accounts/social_security, which deletes all of them. 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: POST /api/v3/accounts/social_security_reports Version: 3.1.0 Security: apiKeyAuth ## 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.year` (integer, required) Required. Supported range 1583 to 9999, except year 9999 with quarter 4 when reported_at is set (500, nothing is saved); a value outside the range may answer 500. Example: 2026 - `social_security_report.quarter` (integer, required) Required, 1 to 4. Example: 2 - `social_security_report.reported_at` (string,null) Optional. Sets submitted_at of the quarter's declaration. Example: "2026-07-15T19:08:03Z" - `social_security_report.estimated_monthly_payment` (number,string,null) Optional, 0 to 9999999999.99. Rounded to 2 places and returned as a decimal string with at least one decimal digit (70 is returned as "70.0"). Example: 53.53 - `social_security_report.monthly_payment` (number,string,null) Optional, 0 to 9999999999.99. Rounded to 2 places and returned as a decimal string with at least one decimal digit (70 is returned as "70.0"). Example: 55.1 ## Response 201 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 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)