# Get company

### Input

User needs to provide `companyNumber` `registry` and `court`

| Attribute     | Type   | Description                                                           |
| ------------- | ------ | --------------------------------------------------------------------- |
| companyNumber | String | The registration number of the company.                               |
| court         | String | The district court where the company is registered.                   |
| registry      | String | The type of registry (e.g., VR, HRA) where the company is registered. |

### Output

| Field              | Type   | Description                                |
| ------------------ | ------ | ------------------------------------------ |
| messageHeader      | Object | The header information of the message.     |
| basicData          | Object | Basic data associated with the procedure.  |
| documentObject     | Object | An empty object for document-related data. |
| recordDataRegister | Object | Data related to the record registration.   |

#### Message Header

| Field               | Type   | Description                                            |
| ------------------- | ------ | ------------------------------------------------------ |
| creationTimestamp   | String | The timestamp indicating when the message was created. |
| ownMessageID        | String | The unique identifier for the message.                 |
| event               | Object | The event information.                                 |
| producerInformation | Object | Information about the producer.                        |

**Event**

| Field | Type   | Description                    |
| ----- | ------ | ------------------------------ |
| code  | String | The code indicating the event. |

**Producer Information**

| Field        | Type   | Description               |
| ------------ | ------ | ------------------------- |
| productName  | String | The name of the product.  |
| producerName | String | The name of the producer. |
| version      | String | The version information.  |

#### Basic Data

| Field         | Type   | Description                    |
| ------------- | ------ | ------------------------------ |
| procedureData | Object | Data related to the procedure. |

**Procedure Data**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| instanceData  | Object | Data related to the instance.           |
| participation | Array  | An array containing participation data. |

**Instance Data**

| Field                      | Type   | Description                          |
| -------------------------- | ------ | ------------------------------------ |
| instanceNumber             | String | The instance number.                 |
| instanceAuthoritySelection | Object | Selection of the instance authority. |
| fileReference              | Object | Reference to the file.               |
| subjectOfTheProceedings    | String | The subject of the proceedings.      |

**Instance Authority Selection**

| Field | Type   | Description            |
| ----- | ------ | ---------------------- |
| court | Object | The court information. |

**Court**

| Field | Type   | Description                    |
| ----- | ------ | ------------------------------ |
| code  | String | The code indicating the court. |

**File Reference**

| Field                   | Type   | Description                    |
| ----------------------- | ------ | ------------------------------ |
| structuredFileReference | Object | The structured file reference. |

**Structured File Reference**

| Field         | Type   | Description               |
| ------------- | ------ | ------------------------- |
| register      | Object | The register information. |
| runningNumber | String | The running number.       |
| year          | String | The year.                 |

#### &#x20;Register

| Field | Type   | Description                       |
| ----- | ------ | --------------------------------- |
| code  | String | The code indicating the register. |

**Participation**

| Field       | Type   | Description                           |
| ----------- | ------ | ------------------------------------- |
| role        | Array  | An array containing role information. |
| participant | Object | Participant information.              |

**Role**

| Field           | Type   | Description                  |
| --------------- | ------ | ---------------------------- |
| roleNumber      | String | The role number.             |
| roleID          | Object | The ID of the role.          |
| roleDescription | Object | The description of the role. |

**Role ID**

| Field             | Type   | Description                    |
| ----------------- | ------ | ------------------------------ |
| id                | String | The ID of the role.            |
| refInstanceNumber | String | The reference instance number. |

**Role Description**

| Field | Type   | Description                               |
| ----- | ------ | ----------------------------------------- |
| code  | String | The code indicating the role description. |

**Participant**

| Field                | Type   | Description                        |
| -------------------- | ------ | ---------------------------------- |
| participantNumber    | String | The participant number.            |
| participantSelection | Object | Participant selection information. |

**Participant Selection**

| Field         | Type   | Description                 |
| ------------- | ------ | --------------------------- |
| organization  | Object | Organization information.   |
| naturalPerson | Object | Natural person information. |

**Organization**

| Field                | Type   | Description              |
| -------------------- | ------ | ------------------------ |
| designation          | Object | Designation information. |
| legalFormInformation | Object | Legal form information.  |
| location             | Object | Location information.    |
| address              | Object | Address information.     |

**Designation**

| Field              | Type   | Description                                  |
| ------------------ | ------ | -------------------------------------------- |
| currentDesignation | String | The current designation of the organization. |

&#x20;**Legal Form Information**

| Field     | Type   | Description             |
| --------- | ------ | ----------------------- |
| legalForm | Object | Legal form information. |

#### &#x20;Legal Form

| Field | Type   | Description                         |
| ----- | ------ | ----------------------------------- |
| code  | String | The code indicating the legal form. |

#### Location

| Field    | Type   | Description                       |
| -------- | ------ | --------------------------------- |
| location | String | The location of the organization. |

**Address**

| Field       | Type   | Description                                     |
| ----------- | ------ | ----------------------------------------------- |
| addressType | Object | Address type information.                       |
| street      | String | The street of the organization's address.       |
| houseNumber | String | The house number of the organization's address. |
| postalCode  | String | The postal code of the organization's address.  |
| city        | String | The city of the organization's address.         |

&#x20;**Address Type**

| Field | Type   | Description                           |
| ----- | ------ | ------------------------------------- |
| code  | String | The code indicating the address type. |

**Natural Person**

| Field    | Type   | Description            |
| -------- | ------ | ---------------------- |
| fullName | Object | Full name information. |
| birth    | Object | Birth information.     |
| gender   | Object | Gender information.    |
| address  | Object | Address information.   |

&#x20;**Full Name**

| Field     | Type   | Description                           |
| --------- | ------ | ------------------------------------- |
| firstName | String | The first name of the natural person. |
| lastName  | String | The last name of the natural person.  |

&#x20;**Birth**

| Field       | Type   | Description                              |
| ----------- | ------ | ---------------------------------------- |
| dateOfBirth | String | The date of birth of the natural person. |

**Gender**

| Field | Type   | Description                                           |
| ----- | ------ | ----------------------------------------------------- |
| code  | String | The code indicating the gender of the natural person. |

#### Record Data Register

| Field                           | Type   | Description                                    |
| ------------------------------- | ------ | ---------------------------------------------- |
| professionalDataRegisterVersion | String | The version of the professional data register. |
| notificationType                | Object | Notification type information.                 |
| affectedLegalEntity             | String | Information about the affected legal entity.   |
| excerpt                         | Object | Excerpt information.                           |

**Notification Type**

| Field | Type   | Description                                |
| ----- | ------ | ------------------------------------------ |
| code  | String | The code indicating the notification type. |

**Excerpt**

| Field            | Type   | Description                  |
| ---------------- | ------ | ---------------------------- |
| registrationText | Array  | Array of registration texts. |
| retrievalTime    | String | The time of retrieval.       |
| retrievalDate    | String | The date of retrieval.       |
| lastEntry        | String | The date of the last entry.  |
| numberOfEntries  | String | The number of entries.       |

```json
{
    "handelsregister": {
        "messageHeader": {
            "creationTimestamp": "2024-04-10T13:38:40Z",
            "ownMessageID": "7c370141-c4a9-437b-84af-c486e76906d9",
            "event": {
                "code": "002"
            },
            "producerInformation": {
                "productName": "RegisSTAR",
                "producerName": "Eviden Germany GmbH",
                "version": " / RSADO: 2.19.1"
            }
        },
        "basicData": {
            "procedureData": {
                "instanceData": {
                    "instanceNumber": "0",
                    "instanceAuthoritySelection": {
                        "court": {
                            "code": "U1104"
                        }
                    },
                    "fileReference": {
                        "fileReferenceSelection": {
                            "structuredFileReference": {
                                "register": {
                                    "code": "HRA"
                                },
                                "runningNumber": "4035",
                                "year": ""
                            }
                        }
                    },
                    "subjectOfTheProceedings": ""
                },
                "participation": [
                    {
                        "role": [
                            {
                                "roleNumber": "1",
                                "roleID": {
                                    "id": "320027493",
                                    "refInstanceNumber": "0"
                                },
                                "roleDescription": {
                                    "code": "287"
                                }
                            }
                        ],
                        "participant": {
                            "participantNumber": "1",
                            "participantSelection": {
                                "organization": {
                                    "designation": {
                                        "currentDesignation": "AZ Verwaltungs GmbH & Co. KG"
                                    },
                                    "legalFormInformation": {
                                        "legalForm": {
                                            "code": "KG"
                                        }
                                    },
                                    "location": {
                                        "location": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    },
                                    "address": {
                                        "addressType": {
                                            "code": "003"
                                        },
                                        "street": "Großenhainer Str.",
                                        "houseNumber": "81/83",
                                        "postalCode": "01127",
                                        "city": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    {
                        "role": [
                            {
                                "roleNumber": "2",
                                "roleID": {
                                    "id": "320000000",
                                    "refInstanceNumber": "0"
                                },
                                "roleDescription": {
                                    "code": "288"
                                }
                            },
                            {
                                "roleNumber": "3",
                                "roleDescription": {
                                    "code": "215"
                                }
                            }
                        ],
                        "participant": {
                            "participantNumber": "2",
                            "participantSelection": {
                                "organization": {
                                    "designation": {
                                        "currentDesignation": "Amtsgericht Dresden"
                                    },
                                    "location": {
                                        "location": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    },
                                    "address": {
                                        "addressType": {
                                            "code": "003"
                                        },
                                        "street": "Olbrichtplatz",
                                        "houseNumber": "1",
                                        "postalCode": "01099",
                                        "city": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    {
                        "role": [
                            {
                                "roleNumber": "4",
                                "roleID": {
                                    "id": "320218216",
                                    "refInstanceNumber": "0"
                                },
                                "roleDescription": {
                                    "code": "285"
                                }
                            }
                        ],
                        "participant": {
                            "participantNumber": "4",
                            "participantSelection": {
                                "naturalPerson": {
                                    "fullName": {
                                        "firstName": "Thomas",
                                        "lastName": "Steinbach"
                                    },
                                    "birth": {
                                        "dateOfBirth": "1967-01-22"
                                    },
                                    "gender": {
                                        "code": "1"
                                    },
                                    "address": {
                                        "addressType": {
                                            "code": "003"
                                        },
                                        "city": "Radebeul",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    {
                        "role": [
                            {
                                "roleNumber": "5",
                                "roleID": {
                                    "id": "320318119",
                                    "refInstanceNumber": "0"
                                },
                                "roleDescription": {
                                    "code": "275"
                                }
                            }
                        ],
                        "participant": {
                            "participantNumber": "5",
                            "participantSelection": {
                                "organization": {
                                    "designation": {
                                        "currentDesignation": "Auto-Holding Dresden GmbH"
                                    },
                                    "location": {
                                        "location": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    },
                                    "address": {
                                        "addressType": {
                                            "code": "003"
                                        },
                                        "city": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    {
                        "role": [
                            {
                                "roleNumber": "6",
                                "roleID": {
                                    "id": "320318117",
                                    "refInstanceNumber": "0"
                                },
                                "roleDescription": {
                                    "code": "252"
                                }
                            }
                        ],
                        "participant": {
                            "participantNumber": "6",
                            "participantSelection": {
                                "organization": {
                                    "designation": {
                                        "currentDesignation": "AHG Komplementär GmbH"
                                    },
                                    "location": {
                                        "location": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    },
                                    "address": {
                                        "addressType": {
                                            "code": "003"
                                        },
                                        "city": "Dresden",
                                        "country": {
                                            "countrySelection": {
                                                "country": {
                                                    "code": "DE"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                ]
            }
        },
        "documentObject": {},
        "recordDataRegister": {
            "professionalDataRegisterVersion": "3.2",
            "notificationType": {
                "code": "002"
            },
            "affectedLegalEntity": "",
            "excerpt": {
                "registrationText": [
                    {
                        "column": "6",
                        "position": "2",
                        "runningNumber": "2",
                        "registrationType": {
                            "code": "004"
                        },
                        "text": "Tag der ersten Eintragung: 09.03.2000. Dieses Blatt ist zur Fortführung auf EDV umgeschrieben worden und dabei an die Stelle des bisherigen Registerblattes getreten."
                    },
                    {
                        "column": "5",
                        "position": "2",
                        "runningNumber": "1",
                        "registrationType": {
                            "code": "011"
                        },
                        "text": "Die Auto Zentrum Dresden GmbH & Co.KG mit dem Sitz in Dresden (Amtsgericht Dresden, HRA 4044) ist auf Grund des Verschmelzungsvertrages vom 21.09.2020 und der Beschlüsse der Gesellschafterversammlungen der beteiligten Rechtsträger jeweils vom selben Tag mit der Gesellschaft im Wege der Aufnahme verschmolzen."
                    },
                    {
                        "column": "5",
                        "position": "2",
                        "runningNumber": "2",
                        "registrationType": {
                            "code": "011"
                        },
                        "text": "Die Firma ist geändert."
                    },
                    {
                        "column": "5",
                        "position": "2",
                        "runningNumber": "1",
                        "registrationType": {
                            "code": "011"
                        },
                        "text": "Die Firma ist geändert."
                    }
                ],
                "retrievalTime": "13:38:40",
                "retrievalDate": "2024-04-10",
                "lastEntry": "2022-08-03",
                "numberOfEntries": "9"
            },
            "basicDataRegister": {
                "legalEntity": {
                    "designation": {
                        "currentDesignation": "AZ Verwaltungs GmbH & Co. KG"
                    },
                    "legalFormInformation": {
                        "legalForm": {
                            "code": "KG"
                        }
                    },
                    "location": {
                        "location": "Dresden"
                    }
                },
                "representation": {
                    "generalRepresentationRegulation": {
                        "representationAuthorizationSelection": {
                            "representationAuthorization": {
                                "code": "089"
                            }
                        }
                    }
                },
                "subject": "",
                "businessPurpose": ""
            }
        }
    }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.transactionlink.io/docs/v1/integrations/handelsregister/company-profile/get-company.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
