> ## Documentation Index > Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt > Use this file to discover all available pages before exploring further. # Company anagraphic > State aid and risk indicators have their own endpoints. Price: 10 credits per record returned; notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and will be accepted on the same path once client support is widespread. ## OpenAPI ````yaml api-reference/openapi.standard.json POST /companies/anagraphic openapi: 3.1.0 info: title: Syrto API - standard endpoints version: 1.7.0 description: >- Financial, corporate and market data on Italian companies. Every call answers `200 { data, meta }`; `meta.usage.quantity` is what the call consumed, in credits, and `meta.warnings` lists any non-fatal caveats (empty when there are none). Every field is always present and unknown values are null. Percentages are fractions (0.15 = 15%). **Authentication.** Every call needs an API key, sent as `Authorization: Bearer sk_...` over HTTPS - never in a URL. Keys are scoped to your organization: admins create and revoke them in the Syrto dashboard (https://dashboard.syrto.ai/api-keys). A missing or unrecognised key is a 401 (`missing_api_key`, `invalid_api_key`); a 503 `auth_unavailable` means the key could not be checked right now, so retry with backoff rather than rotating it. **Billing basis.** negativities, rna and structure bill once per legal entity: the individual and consolidated records of the same company count once. Every other endpoint bills per record (or per call), so individual and consolidated count separately. A tax id always resolves to a single record (`statementBasis`, individual by default): a company is billed twice only when both of its companyIds are passed. A market call is priced per call, whatever the size of its set: omitting `filters` and `seedId`, or sending `filters: {}`, is the whole of Italy, at the same price. notFound entries are never billed, and neither is any error. servers: - url: https://api.syrto.ai security: [] tags: - name: Company data description: Identity, risk flags, state aid and branches of known companies. - name: Governance description: Ownership, officers, beneficial owners and group. - name: Financials description: Statement items, reclassified statements, indices and spider graph. - name: Composite description: Comparable companies. - name: Search description: The companies of a filtered set, row by row. - name: Market description: Aggregates over a filtered set. - name: Catalog description: Free reference data. paths: /companies/anagraphic: post: tags: - Company data summary: >- Identity, classification, location, size and contacts of up to 20 companies. description: >- State aid and risk indicators have their own endpoints. Price: 10 credits per record returned; notFound entries are free. Read-only and idempotent: POST is used only because the request carries a body. The HTTP QUERY method is the preferred verb for this operation and will be accepted on the same path once client support is widespread. operationId: company-anagraphic requestBody: required: true content: application/json: schema: type: object properties: ids: type: array items: type: string minLength: 1 maxLength: 100 minItems: 1 maxItems: 20 description: >- 1-20 references, each a companyId (Syrto id of one statement record, starts with `Zm86`) or a tax id (11-digit partita IVA or 16-character codice fiscale). A tax id resolves to the record selected by `statementBasis`. Duplicates are rejected. example: - '02579690039' - '03841740016' statementBasis: type: string enum: - individual - consolidated description: >- Which statement a tax id resolves to: `individual` (default) is the one the company filed for itself, `consolidated` the group's. The two can differ by orders of magnitude. Ignored for a companyId, which already names one record. year: type: integer minimum: 2015 maximum: 2100 description: >- Financial year (2015-2100). Omitted: the latest filed statement. Forecast years are never returned. language: type: string enum: - it - en description: >- Language of metric names, labels and descriptions (never of field names or slugs). Omitted: the account's default. required: - ids additionalProperties: false responses: '200': description: >- Identity, classification, location, size and contacts of up to 20 companies. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/CompanyAnagraphicBatch' meta: $ref: '#/components/schemas/ResponseMeta' required: - data - meta '401': description: missing_api_key | invalid_api_key content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: credits_exhausted | limit_reached content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: client_not_configured | not_entitled content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: unknown_endpoint | not_found content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: payload_too_large content: application/json: schema: $ref: '#/components/schemas/Error' '415': description: unsupported_media_type content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: invalid_params content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: rate_limited headers: Retry-After: description: >- Seconds to wait before retrying. Neither a 429 nor a 504 is billed. A 504 whose query had reached the data service leaves it running, and its answer is cached, so the same call after this delay is usually fast. schema: type: integer minimum: 0 content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: internal_error content: application/json: schema: $ref: '#/components/schemas/Error' '502': description: upstream_error content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: auth_unavailable | entitlement_unavailable content: application/json: schema: $ref: '#/components/schemas/Error' '504': description: upstream_timeout headers: Retry-After: description: >- Seconds to wait before retrying. Neither a 429 nor a 504 is billed. A 504 whose query had reached the data service leaves it running, and its answer is cached, so the same call after this delay is usually fast. schema: type: integer minimum: 0 content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: CompanyAnagraphicBatch: type: object properties: items: type: array items: $ref: '#/components/schemas/CompanyAnagraphic' description: Resolved entries, in input order. notFound: type: array items: $ref: '#/components/schemas/NotFoundEntry' required: - items - notFound ResponseMeta: type: object properties: requestId: type: string endpoint: type: string usage: $ref: '#/components/schemas/Usage' warnings: type: array items: $ref: '#/components/schemas/Warning' description: Empty when there are none. required: - requestId - endpoint - usage - warnings Error: type: object properties: error: type: object properties: code: type: string enum: - missing_api_key - invalid_api_key - credits_exhausted - limit_reached - client_not_configured - not_entitled - unknown_endpoint - not_found - payload_too_large - unsupported_media_type - invalid_params - rate_limited - internal_error - upstream_error - auth_unavailable - entitlement_unavailable - upstream_timeout message: type: string requestId: type: string details: type: array items: type: object properties: path: type: string message: type: string required: - path - message required: - code - message - requestId required: - error CompanyAnagraphic: allOf: - $ref: '#/components/schemas/CompanyHeader' - type: object properties: year: type: - integer - 'null' description: >- Financial year the size and employee figures describe; null when none is filed. financialStatementDate: type: - string - 'null' format: date description: >- Date of the financial statement the figures come from: the financial year end it is made up to (data di chiusura dell'esercizio - 31 December for most companies, 30 June for a club closing in June). Cite it when reporting a discrepancy. vatNumber: type: - string - 'null' legalEntityType: type: - string - 'null' description: 'Legal form: S.r.l., S.p.A., ...' naceSection: type: - string - 'null' description: Letter A-U. naceDivision: type: - string - 'null' description: Two digits. naceGroup: type: - string - 'null' description: e.g. 27.9 naceClass: type: - string - 'null' description: e.g. 27.90 naceSubclass: type: - string - 'null' description: Italian ATECO subclass, e.g. 27.90.01 activityOverview: type: - string - 'null' targetMarkets: type: array items: $ref: '#/components/schemas/TargetMarket' description: Every channel the company serves; a company can serve several. targetMarketsDescription: type: - string - 'null' city: type: - string - 'null' nuts1: type: - string - 'null' nuts2: type: - string - 'null' nuts3: type: - string - 'null' lau: type: - string - 'null' description: ISTAT municipality code. countryCode: type: - string - 'null' description: ISO 3166-1 alpha-2. sizeClassification: anyOf: - $ref: '#/components/schemas/SizeBand' - type: 'null' description: >- Size of THIS statement record: a holding is usually XS alone and L consolidated. employeeCount: type: - integer - 'null' headcountEmployees: $ref: '#/components/schemas/Headcount' headcountContractors: $ref: '#/components/schemas/Headcount' foundingYear: type: - integer - 'null' incorporationDate: type: - string - 'null' format: date activityStartDate: type: - string - 'null' format: date websiteUrl: type: - string - 'null' contactEmails: type: array items: $ref: '#/components/schemas/TaggedContact' contactPhones: type: array items: $ref: '#/components/schemas/TaggedContact' socialMediaProfiles: type: array items: $ref: '#/components/schemas/SocialMediaProfile' pec: type: - string - 'null' description: Certified email (PEC) for official notices. rea: type: - string - 'null' description: REA registration number. cciaa: type: - string - 'null' description: Chamber of commerce (CCIAA) of registration. required: - year - financialStatementDate - vatNumber - legalEntityType - naceSection - naceDivision - naceGroup - naceClass - naceSubclass - activityOverview - targetMarkets - targetMarketsDescription - city - nuts1 - nuts2 - nuts3 - lau - countryCode - sizeClassification - employeeCount - headcountEmployees - headcountContractors - foundingYear - incorporationDate - activityStartDate - websiteUrl - contactEmails - contactPhones - socialMediaProfiles - pec - rea - cciaa NotFoundEntry: type: object properties: position: type: integer minimum: 0 description: Index in the `ids` array. input: type: string reason: type: string enum: - not_found - no_filing_for_year - invalid_id required: - position - input - reason description: An id that did not resolve. Never billed. Usage: type: object properties: quantity: type: number unit: type: string required: - quantity - unit Warning: type: object properties: code: type: string message: type: string required: - code - message CompanyHeader: type: object properties: companyId: type: string description: >- Syrto id of this statement record. Individual and consolidated differ. legalName: type: - string - 'null' taxId: type: - string - 'null' description: Codice fiscale / partita IVA. consolidated: type: boolean description: Whether these figures are the consolidated (group) statement. required: - companyId - legalName - taxId - consolidated TargetMarket: type: string enum: - B2B - B2C - B2G - B2B2C - B2B2G - C2C - C2B - G2C - G2B SizeBand: type: string enum: - XS - S - M - L description: >- EU size class of the statement record (not of the group, unless consolidated). Headcount: type: object properties: value: type: - integer - 'null' updatedAt: type: - string - 'null' format: date required: - value - updatedAt TaggedContact: type: object properties: value: type: string tags: type: array items: type: string required: - value - tags SocialMediaProfile: type: object properties: platform: type: string url: type: string required: - platform - url securitySchemes: bearerAuth: type: http scheme: bearer description: >- Org-scoped WorkOS API key (sk_...), sent as `Authorization: Bearer `. Admins create and revoke keys in the Syrto dashboard: https://dashboard.syrto.ai/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.