> For the complete documentation index, see [llms.txt](https://legacy-docs.usesmileid.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://legacy-docs.usesmileid.com/further-reading/faqs/what-are-top-level-keys.md).

# What are top-level keys?

Due to discrepancies of keys returned from our providers, we have filtered and standardised the JSON top-level keys below to simplify the use of our JSON response across all our supported ID types.

| Key                          | Description                                                                                                                                                           | Example                                                  |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Country                      | Country where ID was issued                                                                                                                                           | "NG"                                                     |
| IDType                       | The type of ID that was issued                                                                                                                                        | "DRIVERS\_LICENSE"                                       |
| IDNumber                     | The ID number that was looked up in the ID authority database                                                                                                         | "ABC000000000"                                           |
| SecondaryIDNumber            | Another ID number that is tied to another ID type ( different from the ID type been looked up) e.g. SA Passport also has the SA National ID printed on the data page. | "000000000"                                              |
| ExpirationDate               | Expiration date of the ID card (when applicable)                                                                                                                      | "2021-08-15"                                             |
| IssuanceDate                 | <p>Issuance date of the ID card<br>(when applicable)</p>                                                                                                              | "2000-03-20"                                             |
| FullName                     | Full name of ID owner                                                                                                                                                 | "Leo Doe Joe"                                            |
| DOB                          | Date of birth of ID owner                                                                                                                                             | "2000-09-20"                                             |
| Photo                        | Photo of ID owner on file in the ID authority database                                                                                                                | `Base64 Encoded String`                                  |
| PhoneNumber                  | Phone number of ID owner                                                                                                                                              | "12345678900"                                            |
| PhoneNumber2                 | Second phone number of ID owner (when available)                                                                                                                      | "Not Available"                                          |
| Document                     | Photo of ID card on file in the ID authority database (when applicable)                                                                                               | "Not Available"                                          |
| Gender                       | Gender of ID owner                                                                                                                                                    | "Male"                                                   |
| Address                      | <p>Address of ID owner</p><p>NOTE: this might not be the current address of the ID owner</p>                                                                          | "10, Workbox, Ojora Close, Victoria Island, Lagos State" |
| IDNumberPreviouslyRegistered | <p>Boolean value that informs you if ID info has previously been used successfully to register a user.</p><p>Only available on <em>Biometric KYC</em> product.</p>    | \<true \| false>                                         |
| UserIDsOfPreviousRegistrants | <p>Registered User IDs that have previously used the ID info you just queried.</p><p>Only available on <em>Enhanced KYC + SmartSelfie™</em> product.</p>              | \["12134","23456"]                                       |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://legacy-docs.usesmileid.com/further-reading/faqs/what-are-top-level-keys.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
