> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API para criar relatório à UIF a partir de um caso > Crie com a API da Didit um rascunho de SAR, STR, CTR ou outro relatório à UIF a partir de um caso, preenchido com modelo, titular e transações. Prompt da API de criação de relatório a partir de um caso Copiar o prompt para a área de transferência \

\`Create a draft FIU report from a case through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/

Authentication:
Use the x-api-key header with my Didit API key.

Request body (all optional if a template is given):
\{
"template": "",   // seeds rentity_id, submission_code, currency_code_local, etc.
"report_type": "SAR",                     // required if no template
"jurisdiction": "US",                     // required if no template
"transactions": [""]    // optional - defaults to the case's linked transactions
}

Behavior:
\- Draft is auto-populated from the template (if given) plus the case's subject, linked transactions, and a narrative structured around the five Ws (who/what/when/where/why/how) for SAR/STR/TFR.
\- Status starts as DRAFT. Call validate then finalize next.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"template": ""}'

Response 201: RegulatoryReportDetail with status "DRAFT".

Failure modes:
\- 400 - the referenced template was not found.
\- 401/403 - auth/permission errors (requires write:cases).

For the full integration shape, see /integration/integration-prompt.`

\
Colar em Crie um rascunho de relatório vinculado a um caso. Prefira este endpoint ao endpoint de criação independente quando você já estiver com o caso aberto: ele permite omitir `template` e deriva `report_type`/`jurisdiction` diretamente do caso.## Relacionados- [Listar relatórios](https://docs.didit.me/pt-br/management-api/regulatory-reports/list.md) - [Validar relatório](https://docs.didit.me/pt-br/management-api/regulatory-reports/validate.md) - [Finalizar relatório](https://docs.didit.me/pt-br/management-api/regulatory-reports/finalize.md) - [Excluir relatório](https://docs.didit.me/pt-br/management-api/regulatory-reports/delete.md) ## OpenAPI ````yaml pt-br/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/regulatory-reports/: post: tags: - Regulatory Reports summary: Criar relatório a partir de um caso description: >- Cria um rascunho de relatório para a FIU do caso: status DRAFT, preenchido automaticamente a partir do modelo opcional mais o titular do caso, as transações vinculadas e a narrativa. Valide e depois finalize para gerar o XML goAML e o PDF. operationId: create_case_regulatory_report parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID da organização. - name: application_id in: path required: true schema: type: string format: uuid description: UUID da aplicação. - name: case_uuid in: path required: true schema: type: string format: uuid example: c1a5e000-0000-4000-8000-000000000001 description: UUID do caso. requestBody: required: false content: application/json: schema: type: object properties: report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR description: >- Obrigatório, a menos que um modelo seja informado; caso contrário, é usado o report_type do modelo. jurisdiction: type: string minLength: 2 maxLength: 2 description: Obrigatório, a menos que um modelo seja informado. template: type: string format: uuid nullable: true description: >- UUID do modelo de relatório; o field_config dele preenche o rascunho inicial antes de os dados derivados do caso serem mesclados. transactions: type: array items: type: string format: uuid nullable: true description: >- Transações a anexar; por padrão, as transações vinculadas ao caso. rentity_id: type: string nullable: true rentity_branch: type: string nullable: true submission_code: type: string enum: - E - M default: E entity_reference: type: string nullable: true fiu_ref_number: type: string nullable: true currency_code_local: type: string minLength: 3 maxLength: 3 nullable: true submission_date: type: string format: date-time nullable: true reporting_person: type: object location: type: object reason: type: string nullable: true action: type: string nullable: true activity: type: string nullable: true narrative: type: object properties: who: type: string what: type: string when: type: string where: type: string why: type: string how: type: string report_indicators: type: array items: type: string included_fields: type: array items: type: string example: template: 7ec00000-0000-4000-8000-000000000006 responses: '201': description: Rascunho de relatório criado. content: application/json: schema: $ref: '#/components/schemas/RegulatoryReportDetail' '400': description: O modelo referenciado não foi encontrado. content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/regulatory-reports/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"template": "7ec00000-0000-4000-8000-000000000006"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.cases.regulatory_reports.create( "c1a5e000-0000-4000-8000-000000000001", template="7ec00000-0000-4000-8000-000000000006", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.cases.regulatoryReports.create("c1a5e000-0000-4000-8000-000000000001", { template: "7ec00000-0000-4000-8000-000000000006", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.RegulatoryReports.Create(ctx, \"c1a5e000-0000-4000-8000-000000000001\", didit.CasesRegulatoryReportsCreateParams{\n\tTemplate: didit.String(\"7ec00000-0000-4000-8000-000000000006\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.CasesRegulatoryReportsCreateParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().regulatoryReports().create("c1a5e000-0000-4000-8000-000000000001", CasesRegulatoryReportsCreateParams.builder() .template("7ec00000-0000-4000-8000-000000000006") .build()); System.out.println(result); - lang: php label: PHP source: >- cases->regulatoryReports->create('c1a5e000-0000-4000-8000-000000000001', [ 'template' => '7ec00000-0000-4000-8000-000000000006', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.cases.regulatory_reports.create( "c1a5e000-0000-4000-8000-000000000001", template: "7ec00000-0000-4000-8000-000000000006" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Cases.RegulatoryReports.CreateAsync("c1a5e000-0000-4000-8000-000000000001", new CasesRegulatoryReportsCreateParams { Template = "7ec00000-0000-4000-8000-000000000006", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: RegulatoryReportDetail: type: object properties: uuid: type: string format: uuid case_uuid: type: string format: uuid case_number: type: string nullable: true report_type: type: string enum: - SAR - STR - CTR - TTR - UTR - IFT - CBR - TFR report_type_display: type: string report_code: type: string description: >- Código de relatório goAML derivado de report_type, por exemplo STR, CTR, BCR. report_number: type: string nullable: true status: type: string enum: - DRAFT - VALIDATED - FINALIZED status_display: type: string jurisdiction: type: string minLength: 2 maxLength: 2 rentity_id: type: string nullable: true description: ID da entidade declarante emitido pela FIU. rentity_branch: type: string nullable: true submission_code: type: string enum: - E - M entity_reference: type: string nullable: true fiu_ref_number: type: string nullable: true currency_code_local: type: string minLength: 3 maxLength: 3 nullable: true submission_date: type: string format: date-time nullable: true reporting_person: type: object location: type: object reason: type: string nullable: true action: type: string nullable: true activity: type: string nullable: true narrative: type: object description: Seções narrativas no formato dos cinco Ws. properties: who: type: string what: type: string when: type: string where: type: string why: type: string how: type: string report_indicators: type: array items: type: string included_fields: type: array items: type: string transactions: type: array items: type: string format: uuid validation_errors: type: array description: >- Resultado da validação mais recente; cada entrada é um objeto {field, message}. items: type: object properties: field: type: string message: type: string validated_at: type: string format: date-time nullable: true finalized_at: type: string format: date-time nullable: true created_by_email: type: string nullable: true created_by_name: type: string nullable: true created_at: type: string format: date-time updated_at: type: string format: date-time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.