> ## Documentation Index > Fetch the complete documentation index at: https://docs.floral.so/llms.txt > Use this file to discover all available pages before exploring further. # Get a briefing > Get validated structured briefing content. ## OpenAPI ````yaml /openapi/public-v1.json get /api/v1/workspaces/{workspaceSlug}/briefings/{id} openapi: 3.1.0 info: description: Stable external API for relationship lookup and meeting intelligence. title: Floral Public API version: 1.0.0 servers: - description: Production url: https://app.floral.so security: [] tags: - description: Search across active companies and people. name: Search - description: Create, list, inspect, update, archive, and restore companies. name: Companies - description: Create, list, inspect, update, archive, and restore people. name: People - description: Read active public custom-field definitions. name: Custom fields - description: Search normalized Danish company-register facts. name: Company registry - description: Generate, list, and inspect meeting briefings. name: Briefings - description: List, inspect, annotate, and approve meeting summaries. name: Summaries paths: /api/v1/workspaces/{workspaceSlug}/briefings/{id}: get: tags: - Briefings summary: Get a briefing description: Get validated structured briefing content. operationId: getBriefingV1 parameters: - description: Slug of the workspace pinned to the credential. example: acme-nordic in: path name: workspaceSlug required: true schema: maxLength: 100 minLength: 1 pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ type: string - description: Stable numeric resource ID. example: 126 in: path name: id required: true schema: minimum: 1 type: integer - description: >- Optional caller-generated correlation ID. Floral returns the effective value in X-Request-ID. example: 550e8400-e29b-41d4-a716-446655440000 in: header name: X-Request-ID required: false schema: maxLength: 128 minLength: 1 type: string responses: '200': content: application/json: example: briefing: company: id: 42 name: Acme Nordic organizationNumber: '12345678' content: null createdAt: '2026-08-16T08:00:00.000Z' id: 126 name: Acme Nordic briefing status: PENDING updatedAt: '2026-08-16T08:00:00.000Z' version: >- v1.eyJpZCI6MTI2LCJyZXNvdXJjZSI6ImJyaWVmaW5nIiwidmVyc2lvbiI6IjIwMjYtMDgtMTZUMDg6MDA6MDAuMDAwWiJ9 schema: $ref: '#/components/schemas/BriefingDetailResponse' description: Successful response headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string ETag: description: Opaque version for a subsequent If-Match. example: >- "v1.eyJpZCI6MTI2LCJyZXNvdXJjZSI6ImJyaWVmaW5nIiwidmVyc2lvbiI6IjIwMjYtMDgtMTZUMDg6MDA6MDAuMDAwWiJ9" schema: pattern: ^"(?:[^"\\]|\\.)*"$ type: string '400': content: application/json: example: error: code: INVALID_INPUT message: The request contains invalid values. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - INVALID_INPUT type: string required: - code type: object type: object description: 'Stable errors: INVALID_INPUT' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '401': content: application/json: example: error: code: UNAUTHENTICATED message: A valid bearer credential is required. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - UNAUTHENTICATED type: string required: - code type: object type: object description: 'Stable errors: UNAUTHENTICATED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string WWW-Authenticate: description: Bearer authentication challenge. example: Bearer realm="floral-api" schema: type: string '403': content: application/json: example: error: code: FORBIDDEN message: The credential does not grant this operation. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - FORBIDDEN type: string required: - code type: object type: object description: 'Stable errors: FORBIDDEN' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '404': content: application/json: example: error: code: NOT_FOUND message: The resource was not found. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - NOT_FOUND - FEATURE_DISABLED type: string required: - code type: object type: object description: 'Stable errors: NOT_FOUND, FEATURE_DISABLED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string '429': content: application/json: example: error: code: RATE_LIMITED message: Too many requests. Retry shortly. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - RATE_LIMITED type: string required: - code type: object type: object description: 'Stable errors: RATE_LIMITED' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string Retry-After: description: Seconds until the current limit resets. schema: minimum: 1 type: integer '500': content: application/json: example: error: code: INTERNAL_ERROR message: An unexpected error occurred. requestId: 550e8400-e29b-41d4-a716-446655440000 schema: allOf: - $ref: '#/components/schemas/ApiErrorResponse' properties: error: properties: code: enum: - INTERNAL_ERROR type: string required: - code type: object type: object description: 'Stable errors: INTERNAL_ERROR' headers: X-Content-Type-Options: description: Always nosniff for JSON API responses. schema: const: nosniff type: string X-RateLimit-Limit: description: Maximum requests in the current rate-limit window. schema: minimum: 1 type: integer X-RateLimit-Remaining: description: Requests remaining in the current rate-limit window. schema: minimum: 0 type: integer X-Request-ID: description: Stable request or idempotent replay correlation ID. schema: minLength: 1 type: string security: - bearerAuth: [] x-codeSamples: - label: cURL lang: Shell source: |- curl --request GET \ --url 'https://app.floral.so/api/v1/workspaces/acme-nordic/briefings/126' \ --header 'Authorization: Bearer $FLORAL_TOKEN' components: schemas: BriefingDetailResponse: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: briefing: type: object properties: id: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 version: type: string minLength: 1 maxLength: 512 pattern: ^v1\.[A-Za-z0-9_-]+$ name: type: string status: type: string enum: - PENDING - IN_PROGRESS - COMPLETE - FAILED createdAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ company: type: object properties: id: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 name: type: string organizationNumber: type: string required: - id - name - organizationNumber additionalProperties: false content: anyOf: - type: object properties: virksomhedsoplysninger: description: Core company details and contact information anyOf: - type: object properties: virksomhedsnavn: description: The company's registered name anyOf: - type: string - type: 'null' adresse: description: The company's physical address anyOf: - type: string - type: 'null' cvrNummer: description: CVR number (Danish company registration number) anyOf: - type: string - type: 'null' hjemmeside: description: The company's website URL anyOf: - type: string - type: 'null' selskabsform: description: Legal company form, such as A/S or ApS anyOf: - type: string - type: 'null' stiftet: description: Year or date of incorporation anyOf: - type: string - type: 'null' branchekode: description: Industry code and description anyOf: - type: string - type: 'null' kontaktinfo: description: Contact details, including phone and email anyOf: - type: string - type: 'null' direktor: description: Name of the managing director or CEO anyOf: - type: string - type: 'null' bestyrelsesformand: description: Name of the chair of the board anyOf: - type: string - type: 'null' bestyrelsesmedlemmer: description: Names of board members anyOf: - maxItems: 20 type: array items: type: string - type: 'null' legaleEjere: description: Registered owners of the company anyOf: - maxItems: 20 type: array items: type: object properties: navn: type: string ejerandel: anyOf: - type: string - type: 'null' type: anyOf: - type: string - type: 'null' required: - navn additionalProperties: false - type: 'null' additionalProperties: false - type: 'null' opsummering: description: Overall briefing summary anyOf: - type: object properties: virksomhedsresume: description: >- A 3-5 sentence summary of the meeting purpose, strongest documented signal, and main open decision anyOf: - type: string - type: 'null' additionalProperties: false - type: 'null' introduktion: description: >- Short introduction to the company's profile and business area anyOf: - type: object properties: kortIntroduktion: description: >- Short company introduction including founding year, location, employee count, and ownership structure anyOf: - type: string - type: 'null' produktOgKunder: description: >- Description of the company's main products or services and customer segments anyOf: - type: string - type: 'null' additionalProperties: false - type: 'null' regnskabsstatus: description: >- Financial position with reported figures, analysis, and trends anyOf: - type: object properties: regnskabsdata: description: >- Financial key figures by reporting year, usually for the latest five years default: [] anyOf: - maxItems: 5 type: array items: type: object properties: year: description: Reporting year, such as "2024" anyOf: - type: string - type: 'null' bruttofortjeneste: description: >- Gross profit in thousands of DKK, or "X" when unavailable anyOf: - type: string - type: 'null' ebitda: description: >- EBITDA in thousands of DKK, or "X" when unavailable anyOf: - type: string - type: 'null' aaretsResultat: description: >- Net profit in thousands of DKK, or "X" when unavailable anyOf: - type: string - type: 'null' egenkapital: description: >- Equity in thousands of DKK, or "X" when unavailable anyOf: - type: string - type: 'null' balance: description: >- Total assets in thousands of DKK, or "X" when unavailable anyOf: - type: string - type: 'null' likviditetsgrad: description: >- Current ratio as a percentage, or "X" when unavailable anyOf: - type: string - type: 'null' soliditetsgrad: description: >- Equity ratio as a percentage, or "X" when unavailable anyOf: - type: string - type: 'null' antalAnsatte: description: Employee count, or "X" when unavailable anyOf: - type: string - type: 'null' additionalProperties: false - type: 'null' usikkerhedGoingConcern: description: >- Any uncertainty about the going-concern assumption anyOf: - type: string - type: 'null' analyseOgTendenser: description: >- Analysis points describing financial trends, changes in key figures, and material developments over time default: [] anyOf: - maxItems: 10 type: array items: anyOf: - type: string - type: 'null' - type: 'null' required: - regnskabsdata - analyseOgTendenser additionalProperties: false - type: 'null' senesteNyt: description: Recent company news, events, and developments anyOf: - type: object properties: nyheder: description: >- Dated news items covering certifications, major events, technology projects, industry developments, and customer experience. Each item must be concrete and include source links as Markdown links at the end. default: [] anyOf: - maxItems: 10 type: array items: anyOf: - type: string - type: 'null' - type: 'null' required: - nyheder additionalProperties: false - type: 'null' swotAnalyse: description: >- SWOT analysis with strengths, weaknesses, opportunities, and threats anyOf: - type: object properties: styrker: description: >- Specific internal company strengths based on documented facts and observable patterns default: [] anyOf: - maxItems: 8 type: array items: anyOf: - type: string - type: 'null' - type: 'null' svagheder: description: >- Specific internal weaknesses or constraints based on data and available context default: [] anyOf: - maxItems: 8 type: array items: anyOf: - type: string - type: 'null' - type: 'null' muligheder: description: >- External opportunities or growth paths the company can realistically pursue default: [] anyOf: - maxItems: 8 type: array items: anyOf: - type: string - type: 'null' - type: 'null' trusler: description: >- External threats or market risks that could affect the company default: [] anyOf: - maxItems: 8 type: array items: anyOf: - type: string - type: 'null' - type: 'null' required: - styrker - svagheder - muligheder - trusler additionalProperties: false - type: 'null' identificeredeUdfordringer: description: >- Identified challenges based on data and professional assessment anyOf: - type: object properties: direkteData: description: >- Challenges based on directly observable financial data and facts, such as volatility, declining liquidity, or cost structure default: [] anyOf: - maxItems: 8 type: array items: anyOf: - type: string - type: 'null' - type: 'null' fagligeFortolkninger: description: >- Professional interpretations of underlying risks and weaknesses based on data and context, such as project management, recruitment, reputation, or digitalisation default: [] anyOf: - maxItems: 10 type: array items: anyOf: - type: string - type: 'null' - type: 'null' stoetteordningerOgKlynger: description: >- Relevant public support schemes, grant opportunities, and industry clusters the company may use default: [] anyOf: - maxItems: 5 type: array items: anyOf: - type: string - type: 'null' - type: 'null' required: - direkteData - fagligeFortolkninger - stoetteordningerOgKlynger additionalProperties: false - type: 'null' forslagTilSamtalepunkter: description: >- Suggested discussion points for a meeting with company management anyOf: - type: object properties: samtalepunkter: description: >- Three to six short questions for management. Each question must work in a meeting, relate to a specific fact or open decision, and invite discussion. default: [] anyOf: - maxItems: 12 type: array items: anyOf: - type: string - type: 'null' - type: 'null' required: - samtalepunkter additionalProperties: false - type: 'null' additionalProperties: false - type: 'null' required: - id - version - name - status - createdAt - updatedAt - company - content additionalProperties: false required: - briefing additionalProperties: false ApiErrorResponse: additionalProperties: false properties: error: additionalProperties: false properties: code: enum: - CONFLICT - FEATURE_DISABLED - FORBIDDEN - IDEMPOTENCY_CONFLICT - INTERNAL_ERROR - INVALID_INPUT - INVALID_STATE - NOT_FOUND - PRECONDITION_REQUIRED - RATE_LIMITED - UNAUTHENTICATED - VERSION_CONFLICT type: string message: minLength: 1 type: string requestId: maxLength: 128 minLength: 1 type: string required: - code - message - requestId type: object required: - error type: object securitySchemes: bearerAuth: bearerFormat: Floral PAT description: Authenticate with a workspace-pinned Floral personal access token. scheme: bearer type: http ````