---
title: "Get organization detail"
method: GET
path: "/organizations/{cin}/detail"
tags: ["Organizations"]
---

# Get organization detail

`GET /organizations/{cin}/detail`

## Request

- Base URL: `https://api.apino.sk/api/v1`
- URL: `https://api.apino.sk/api/v1/organizations/{cin}/detail`
- Auth: HTTP bearer

Retrieve the full record for an organization, including historical data for names, addresses, legal forms, activities, statutory bodies, stakeholders, and equity.

The `data` field structure depends on the country:
- **SK:** RPORecord with nested arrays (addresses, activities, statutory bodies, etc.)
- **CZ:** CZRESRecord with flat fields (street, municipality, NACE code, etc.)

For Slovak organizations, the response automatically includes a `vat` field with VAT payer status and tax reliability from the Financial Administration.

When a CIN exists in both SK and CZ registers and no `country` parameter is specified, the API returns a **300 Multiple Choices** response listing both options.

> **GDPR note:** Personal identifiers are removed from Slovak data. Statutory body and stakeholder addresses show municipality only. A sole trader's own record, Slovak or Czech, is returned with the current address only; on the free plan with the municipality only and without `sourceRegister` (see the GDPR note in the introduction).

## Path parameters

- `cin` string, required

## Query parameters

- `country` 'SK' | 'CZ'

## Response `200`

Detailed organization record

- DetailedOrganization
  - `withheld` Withheld: Present only when this response was cut on purpose, and absent otherwise. On the free plan a sole trader — a natural person — is returned as on the public website: their street, postal code, register entry and IČ DPH are left out and `address` holds the municipality. This object says so, so that an empty `street` is not mistaken for a register that has none. A company is never cut, on any plan.
    - `reason` 'natural_person', required: Why fields were left out. More values may be added.
    - `fields` string[], required: JSON paths of the fields left out or shortened in this response.
    - `available_on` 'paid_plan', required: Where these fields are served in full.
  - `id` integer, required: Internal ID
  - `country_code` 'SK' | 'CZ', required: Country of registration (SK = Slovakia, CZ = Czech Republic)
  - `name` string, required: Full company name
  - `cin` string, required: CIN (IČO)
  - `address` string: Full formatted address
  - `is_terminated` boolean, required: Whether the company is terminated
  - `created_at` string, date-time: Record creation timestamp
  - `updated_at` string, date-time: When we last wrote this record, not when the register last changed the company. Every sync stamps the rows it touches, and a full re-import stamps all of them, so this moves for reasons that have nothing to do with the company. For "what changed about this company and when", use `/changes`, which says what changed as well as when.
  - `data` union: The register's own record, in the register's own field names. Which shape applies follows `country_code`: `SK` carries an `RPORecord` (camelCase, with validity history and GDPR masking applied), `CZ` a `CZRESRecord` (snake_case, flat, current state only).
    - RPORecord: A Slovak record from the Register of Legal Entities (RPO), as served by `/detail` for `country_code: SK`. Every top-level field is always present. An array or object the register does not hold for the organization is `null` or an empty array — treat the two alike; it is never omitted. Dates are `YYYY-MM-DD` strings. Nested fields are omitted when empty. GDPR masking is applied before the record is sent: in `statutoryBodies`, `stakeholders` and `organizationUnits[].stakeholders`, `identifier` is removed (for persons and legal entities alike) and the address is reduced to municipality, district and country. Names are kept.
      - `id` integer, required: The RPO's own record ID. Not the same as the top-level `id`.
      - `identifiers` TimedValue[], nullable, required: CIN (IČO) history
        - `value` string, required
        - `validFrom` string, date
        - `validTo` string, date
      - `fullNames` TimedValue[], nullable, required: Name history
        - `value` string, required
        - `validFrom` string, date
        - `validTo` string, date
      - `addresses` RPOAddress[], nullable, required: Registered office history. Not masked.
        - `formatedAddress` string: The address as one line, when the register provides one. Spelled as the register spells it.
        - `validFrom` string, date
        - `validTo` string, date
        - `street` string
        - `regNumber` integer: Registration (conscription) number; omitted when 0
        - `buildingNumber` string
        - `postalCodes` string[]
        - `municipality` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `country` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `district` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
      - `legalForms` RPOTimedCodeValue[], nullable, required: Legal form history, as codelist entries (codelist `CL000056`)
        - `value` RPOCodeValue, required: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `validFrom` string, date
        - `validTo` string, date
      - `establishment` string, required: Establishment date (`YYYY-MM-DD`). An empty string when the register gives none, or only its `1800-01-01` placeholder.
      - `termination` string, required: Termination date (`YYYY-MM-DD`). An empty string while the organization is active.
      - `activities` RPOActivity[], nullable, required: Registered business activities, as free text
        - `economicActivityDescription` string, required
        - `validFrom` string, date
        - `validTo` string, date
        - `suspendedFrom` string, date
        - `suspendedTo` string, date
      - `statutoryBodies` StatutoryBody[], nullable, required: Directors, board members, liquidators and similar (GDPR-masked)
        - `stakeholderType` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `statutoryBodyMember` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `validFrom` string, date
        - `validTo` string, date
        - `address` RPOMaskedAddress: The address of a statutory body member or a stakeholder after GDPR masking: street, numbers and postal codes are removed. `formatedAddress` is rebuilt from municipality and country. Every field is omitted when empty.
          - `formatedAddress` string: "<municipality>, <country>"
          - `validFrom` string, date
          - `validTo` string, date
          - `municipality` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `country` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `district` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `personName` RPOPersonName: A natural person's name. Every field is omitted when empty.
          - `formatedName` string: The whole name as one string
          - `givenNames` string[]
          - `familyNames` string[]
          - `givenFamilyNames` string[]: Family names at birth
          - `prefixes` RPOCodeValue[]: Academic titles before the name
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `postfixes` RPOCodeValue[]: Academic titles after the name
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `fullName` string: Name of a legal entity
        - `establishment` string, date: Establishment date of a legal entity
        - `termination` string, date: Termination date of a legal entity
      - `stakeholders` Stakeholder[], nullable, required: Shareholders, partners, founders and similar (GDPR-masked)
        - `stakeholderType` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `validFrom` string, date
        - `validTo` string, date
        - `address` RPOMaskedAddress: The address of a statutory body member or a stakeholder after GDPR masking: street, numbers and postal codes are removed. `formatedAddress` is rebuilt from municipality and country. Every field is omitted when empty.
          - `formatedAddress` string: "<municipality>, <country>"
          - `validFrom` string, date
          - `validTo` string, date
          - `municipality` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `country` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `district` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `personName` RPOPersonName: A natural person's name. Every field is omitted when empty.
          - `formatedName` string: The whole name as one string
          - `givenNames` string[]
          - `familyNames` string[]
          - `givenFamilyNames` string[]: Family names at birth
          - `prefixes` RPOCodeValue[]: Academic titles before the name
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `postfixes` RPOCodeValue[]: Academic titles after the name
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `fullName` string: Name of a legal entity
        - `establishment` string, date: Establishment date of a legal entity
        - `termination` string, date: Termination date of a legal entity
      - `otherLegalFacts` TimedValue[], nullable, required: Other registered facts, as free text
        - `value` string, required
        - `validFrom` string, date
        - `validTo` string, date
      - `authorizations` TimedValue[], nullable, required: How the organization is represented and who signs for it, as free text
        - `value` string, required
        - `validFrom` string, date
        - `validTo` string, date
      - `equities` RPOEquity[], nullable, required: Registered capital. The register usually publishes the subscribed amount (`value`) and the paid-up amount (`valuePaid`) as separate entries.
        - `validFrom` string, date
        - `validTo` string, date
        - `value` string: Subscribed capital, a decimal number as a string (e.g. `"5000.00"`)
        - `valuePaid` string: Paid-up capital, a decimal number as a string
        - `currency` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
      - `deposits` RPODeposit[], nullable, required: Contributions of individual members to the registered capital
        - `validFrom` string, date
        - `validTo` string, date
        - `personName` RPOPersonName: A natural person's name. Every field is omitted when empty.
          - `formatedName` string: The whole name as one string
          - `givenNames` string[]
          - `familyNames` string[]
          - `givenFamilyNames` string[]: Family names at birth
          - `prefixes` RPOCodeValue[]: Academic titles before the name
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `postfixes` RPOCodeValue[]: Academic titles after the name
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `amount` string: A decimal number as a string
        - `currency` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
      - `shares` RPOShare[], nullable, required: Shares issued (joint-stock companies)
        - `validFrom` string, date
        - `validTo` string, date
        - `shareType` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `shareValue` string: Nominal value of one share, a decimal number as a string
        - `shareCount` integer
        - `currency` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
      - `sourceRegister` RPOSourceRegister, required: Every field is omitted when empty.
        - `value` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `registrationOffices` TimedValue[]: Court or office keeping the record
          - `value` string, required
          - `validFrom` string, date
          - `validTo` string, date
        - `registrationNumbers` TimedValue[]: File number in that register, e.g. `Sro/56924/B`
          - `value` string, required
          - `validFrom` string, date
          - `validTo` string, date
      - `predecessors` RPORelatedOrganization[], nullable, required: Legal predecessors (mergers, divisions, conversions)
        - `identifier` string: CIN (IČO)
        - `fullName` string
      - `successors` RPORelatedOrganization[], nullable, required: Legal successors
        - `identifier` string: CIN (IČO)
        - `fullName` string
      - `statisticalCodes` RPOStatisticalCodes, required: Every field is omitted when empty.
        - `statCodesActualization` string, date: When the Statistical Office last updated these codes
        - `mainActivity` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `esa2010` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
      - `organizationUnits` RPOOrganizationUnit[], nullable, required: Branches and other organizational units
        - `identifier` string: The unit's own CIN (IČO), when it has one
        - `fullNames` TimedValue[]
          - `value` string, required
          - `validFrom` string, date
          - `validTo` string, date
        - `addresses` RPOAddress[]
          - `formatedAddress` string: The address as one line, when the register provides one. Spelled as the register spells it.
          - `validFrom` string, date
          - `validTo` string, date
          - `street` string
          - `regNumber` integer: Registration (conscription) number; omitted when 0
          - `buildingNumber` string
          - `postalCodes` string[]
          - `municipality` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `country` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `district` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `unitType` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
          - `value` string, required: Text of the entry, in Slovak
          - `code` string: Code within the codelist
          - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
        - `stakeholders` Stakeholder[]: Heads of the unit (GDPR-masked)
          - `stakeholderType` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
            - `value` string, required: Text of the entry, in Slovak
            - `code` string: Code within the codelist
            - `codelistCode` string: Codelist identifier, e.g. `CL000086` for countries
          - `validFrom` string, date
          - `validTo` string, date
          - `address` RPOMaskedAddress: The address of a statutory body member or a stakeholder after GDPR masking: street, numbers and postal codes are removed. `formatedAddress` is rebuilt from municipality and country. Every field is omitted when empty.
            - `formatedAddress` string: "<municipality>, <country>"
            - `validFrom` string, date
            - `validTo` string, date
            - `municipality` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
              - …
            - `country` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
              - …
            - `district` RPOCodeValue: A value from an RPO codelist. `code` and `codelistCode` are omitted when the register gives only the text.
              - …
          - `personName` RPOPersonName: A natural person's name. Every field is omitted when empty.
            - `formatedName` string: The whole name as one string
            - `givenNames` string[]
            - `familyNames` string[]
            - `givenFamilyNames` string[]: Family names at birth
            - `prefixes` RPOCodeValue[]: Academic titles before the name
              - …
            - `postfixes` RPOCodeValue[]: Academic titles after the name
              - …
          - `fullName` string: Name of a legal entity
          - `establishment` string, date: Establishment date of a legal entity
          - `termination` string, date: Termination date of a legal entity
    - CZRESRecord: A Czech record from the Register of Economic Subjects (RES), published by the Czech Statistical Office, as served by `/detail` for `country_code: CZ`. Current state only, with no history. Values are the Statistical Office's own, as strings: dates as `YYYY-MM-DD`, and codes from its codelists. Every field except `ico` and `firma` is omitted when empty. Not masked: RES holds no personal identifiers.
      - `ico` string, required: CIN (IČO), 8 digits
      - `firma` string, required: Name
      - `founded` string, date: Date of establishment
      - `dissolved` string, date: Date of dissolution; absent while the subject exists
      - `legal_form_stat` string: Legal form, statistical codelist (e.g. `112` s.r.o., `121` a.s., `301` state enterprise)
      - `legal_form_reg` string: Legal form as recorded in the source register
      - `nace` string: Main economic activity, CZ-NACE
      - `nace_2025` string: Main economic activity, CZ-NACE 2025
      - `employee_category` string: Employee-count category code
      - `esa2010_sector` string: Institutional sector, ESA 2010
      - `district_code` string: District code (LAU 1), e.g. `CZ0100` for Prague
      - `iczuj` string: Municipality code (IČZÚJ)
      - `address_code` string: Address point code (RÚIAN)
      - `text_address` string: Address as free text, used when there is no structured address
      - `postal_code` string
      - `municipality` string
      - `municipality_part` string
      - `street` string
      - `house_number_type` string: Kind of house number (`1` descriptive, `2` registration)
      - `house_number` string
      - `orient_number` string: Orientation (street) number
      - `dissolve_reason` string: Reason for dissolution, code
      - `updated_date` string, date: When the Statistical Office last updated the record
      - `data_valid_date` string, date: Date the snapshot is valid for
      - `change_flag` string: Change flag from the snapshot
  - `vat` VATInfo: Lightweight VAT & tax summary embedded in organization responses (SK only)
    - `is_vat_payer` boolean, required: A VAT payer (*platiteľ DPH*) under § 4, § 4b or § 5 of the VAT Act. **Not the same as holding an IČ DPH:** a subject registered under § 7 or § 7a has one for cross-border dealings, charges no VAT on domestic supplies and has no right to deduct — `is_vat_payer` is `false` for it, with `ic_dph` and `registration_type` still filled in. Decided the way the Financial Administration publishes it: a payer is a subject with a date it became one.
    - `ic_dph` string, nullable: VAT ID (IČ DPH), e.g. `SK2020270780`
    - `registration_type` string, nullable: VAT registration type (e.g. §4, §7, §7a)
    - `tax_reliability` 'vysoko spoľahlivý' | 'spoľahlivý' | 'menej spoľahlivý' | 'null', nullable: Tax reliability index from the Financial Administration: - `vysoko spoľahlivý` — highly reliable - `spoľahlivý` — reliable - `menej spoľahlivý` — less reliable
    - `deregistered_on` string, date: When the company left the VAT register — the erasure date the Financial Administration published, or the day its list stopped carrying the company. Present only when it has left; as in `/vat/verify`.
    - `deregistration_reason` 'erased' | 'not_in_register': `erased` — struck off by the Financial Administration, a published fact. `not_in_register` — no longer on its list, which is an inference. Present only when the company has left the register.
    - `deregistration_grounds` DeregistrationGrounds: Present while the VAT payer is on the Financial Administration's list of payers with grounds for cancellation of registration (`ds_dphz`, § 69 ods. 14 of the VAT Act); absent otherwise. Only ever set on a current VAT payer: the list keeps a few entries for subjects since struck off or now registered under § 7 or § 7a, and for those `deregistration_reason` or `registration_type` already says what matters. The company **is still a VAT payer** — `is_vat_payer` is unaffected. The tax authority has found grounds to cancel the registration (under § 81 ods. 3 písm. b) bod 2 of the Act) and has made that public. It is a warning, not a cancellation. When a registration is cancelled the company leaves this list and `deregistration_reason` becomes `erased`. Being on the list is not by itself one of the grounds § 69 ods. 13 names for a customer to become liable for the supplier's unpaid VAT. It is a published risk signal: a reason to look more closely before paying.
      - `published_on` string, date, required: When the Financial Administration published the company on the list (YYYY-MM-DD).
      - `violation_year` string: The year the grounds arose, when the list states it.

## Other responses

- `300`: CIN exists in multiple countries — specify `?country=SK` or `?country=CZ`
- `400`: Validation error
- `401`: Missing or invalid API key
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/apino/apis/apino-api.md) · [All operations](https://skmtc.dev/apino/apis/apino-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apino/apis/apino-api/revisions/d172569847cd?raw)