Get a single document by its id.

Path parameters

entityIdstringRequired

documentIdstringRequired

Headers

Query parameters

levelenumOptionalDefaults to meta

Determines what level of detail to return in the response

meta: Return all metadata only, no links or base64 data
base64: Return all metadata and images as base64

Determines what level of detail to return in the response - meta: Return all metadata only, no links or base64 data - base64: Return all metadata and images as base64

Allowed values:

Response

typeenum

Valid document ID types.

“OTHER”: Generic document type. Unspecified.
“DRIVERS_LICENSE”: Driver’s license.
“PASSPORT”: Passport.
“VISA”: Visa document (not Visa payment card).
“IMMIGRATION”: Immigration card.
“NATIONAL_ID”: Any national ID card.
“TAX_ID”: Any national tax identifier.
“NATIONAL_HEALTH_ID”: Any national health program ID card (e.g., Medicare, NHS).
“CONCESSION”: State-issued concession card.
“HEALTH_CONCESSION”: State-issued health-specific concession card.
“PENSION”: State-issued pension ID.
“MILITARY_ID”: Military ID.
“BIRTH_CERT”: Birth certificate.
“CITIZENSHIP”: Citizenship certificate.
“MARRIAGE_CERT”: Marriage certificate.
“DEATH_CERT”: Death certificate.
“NAME_CHANGE”: Name change confirmation.
“UTILITY_BILL”: Regulated utility bill, such as electricity, gas, etc.
“BANK_STATEMENT”: Bank/card statement.
“BANK_ACCOUNT”: Bank account.
“INTENT_PROOF”: Proof of intent, generally a photo/video or a scanned letter.
“ATTESTATION”: Document of attestation (e.g., Statutory Declaration).

NOTE: These cannot be used as a supporting document:

“SELF_IMAGE”: A “selfie” used for comparisons.
“DEVICE”: Device ID.
“VEHICLE_REGISTRATION”: Vehicle registration number.
“PROOF_OF_ADDRESS”: Any document that provides proof of address.
“HOUSE_REGISTRATION”: House registration document.
“YELLOW_HOUSE_REGISTRATION”: Yellow House Registration Thor Ror 13.
“WORK_PERMIT”: Work permit.
“EMPLOYMENT_CERTIFICATE”: Certificate of employment.
“NOTARY_PUBLIC_ID”: Notary Public Identification.

Business-related documentation:

“EXTERNAL_ADMIN”: Details of appointed administrator.
“CHARGES”: Details of any charges laid against a company or director.
“PRE_ASIC”: Any documents that are Pre-ASIC.
“ANNUAL_RETURN”: Details of a company’s annual return.
“REPORT”: Frankie-generated report.
“TRUST_DEED”: Corporate trust deed.
“PARTNERSHIP_AGREEMENT”: Partnership agreement documents.
“ADMIN_CHANGE”: Change of administrator.
“COMPANY_REPORT”: Registry-filed company reports.

Special document types:

“CHECK_RESULTS”: Special document type for specifying results of checks completed other than through Frankie.
“AVIATION_SECURITY_ID”: Aviation Security Identification Card.
“MARITIME_SECURITY_ID”: Maritime Security Identification Card.

Valid document ID types. - "OTHER": Generic document type. Unspecified. - "DRIVERS_LICENSE": Driver's license. - "PASSPORT": Passport. - "VISA": Visa document (not Visa payment card). - "IMMIGRATION": Immigration card. - "NATIONAL_ID": Any national ID card. - "TAX_ID": Any national tax identifier. - "NATIONAL_HEALTH_ID": Any national health program ID card (e.g., Medicare, NHS). - "CONCESSION": State-issued concession card. - "HEALTH_CONCESSION": State-issued health-specific concession card. - "PENSION": State-issued pension ID. - "MILITARY_ID": Military ID. - "BIRTH_CERT": Birth certificate. - "CITIZENSHIP": Citizenship certificate. - "MARRIAGE_CERT": Marriage certificate. - "DEATH_CERT": Death certificate. - "NAME_CHANGE": Name change confirmation. - "UTILITY_BILL": Regulated utility bill, such as electricity, gas, etc. - "BANK_STATEMENT": Bank/card statement. - "BANK_ACCOUNT": Bank account. - "INTENT_PROOF": Proof of intent, generally a photo/video or a scanned letter. - "ATTESTATION": Document of attestation (e.g., Statutory Declaration). NOTE: These cannot be used as a supporting document: - "SELF_IMAGE": A "selfie" used for comparisons. - "DEVICE": Device ID. - "VEHICLE_REGISTRATION": Vehicle registration number. - "PROOF_OF_ADDRESS": Any document that provides proof of address. - "HOUSE_REGISTRATION": House registration document. - "YELLOW_HOUSE_REGISTRATION": Yellow House Registration Thor Ror 13. - "WORK_PERMIT": Work permit. - "EMPLOYMENT_CERTIFICATE": Certificate of employment. - "NOTARY_PUBLIC_ID": Notary Public Identification. Business-related documentation: - "EXTERNAL_ADMIN": Details of appointed administrator. - "CHARGES": Details of any charges laid against a company or director. - "PRE_ASIC": Any documents that are Pre-ASIC. - "ANNUAL_RETURN": Details of a company's annual return. - "REPORT": Frankie-generated report. - "TRUST_DEED": Corporate trust deed. - "PARTNERSHIP_AGREEMENT": Partnership agreement documents. - "ADMIN_CHANGE": Change of administrator. - "COMPANY_REPORT": Registry-filed company reports. Special document types: - "CHECK_RESULTS": Special document type for specifying results of checks completed other than through Frankie. - "AVIATION_SECURITY_ID": Aviation Security Identification Card. - "MARITIME_SECURITY_ID": Maritime Security Identification Card.

countrystring<=3 characters

The ISO 3166 alpha-3 country code where the document was issued, if relevant. For more information, please refer to: https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

documentIdstring or nullformat: "uuid"

As documents are added to an entity, they are assigned a unique identifier to assist with modification and reference. To modify a document, include the documentId in an update request.

entityIdstring or null

Entities are assigned an auto-generated UUID to ensure global uniqueness, represented as entityId. The entityId allows for precise modification when required. To modify an entity, set the entityId of the entity you wish to update in an update request.

expiryDateobject or null

The expiry date of the document in YYYY-MM-DD format.

issueDateobject or null

The issue date of the document in YYYY-MM-DD format.

primaryIdentifierstring or null

The primary ID number of the document, e.g., the ID number on a driver licence.

secondaryIdentifierstring or null

The secondary ID number of the document, e.g., the card number on a driver licence.

subtypestring or null

The sub-type of the document, if relevant. This can include specific report or attestation types, e.g., FACIAL_COMPARISON (attestation) or KYC (report).

subdivisionstring or null

The abbreviated ISO 3166 subdivision/region where the ID was issued, e.g., “VIC” for the Australian state of Victoria or “MA” for the US state of Massachusetts.

createdAtstring or nullformat: "date-time"

The date and time when the document record was created, in ISO 8601 format.

updatedAtstring or nullformat: "date-time"

The date and time when the document record was last updated, in ISO 8601 format.

validFromobject or null

The date when the validity period for this document began, if applicable.

validToobject or null

The date when the validity period for this document ended, if applicable.

sourceIdstring or null

The source from which specific information was sourced. This is a link to an informationSource object in the informationSources map.

supplementaryDataobject or null

Supplementary information relevant to a specific document or report type.

customAttributesmap from strings to objects or null

attachmentslist of objects or null

List of scans, pages, or files for a single document, e.g., front and back images of a driver licence, or page 1, 2, and 3 of a supporting document. Attachments can be uploaded in a single call or in multiple calls. To upload attachments over multiple calls, include the documentId in the request.

Errors

Valid document ID types.

“OTHER”: Generic document type. Unspecified.
“DRIVERS_LICENSE”: Driver’s license.
“PASSPORT”: Passport.
“VISA”: Visa document (not Visa payment card).
“IMMIGRATION”: Immigration card.
“NATIONAL_ID”: Any national ID card.
“TAX_ID”: Any national tax identifier.
“NATIONAL_HEALTH_ID”: Any national health program ID card (e.g., Medicare, NHS).
“CONCESSION”: State-issued concession card.
“HEALTH_CONCESSION”: State-issued health-specific concession card.
“PENSION”: State-issued pension ID.
“MILITARY_ID”: Military ID.
“BIRTH_CERT”: Birth certificate.
“CITIZENSHIP”: Citizenship certificate.
“MARRIAGE_CERT”: Marriage certificate.
“DEATH_CERT”: Death certificate.
“NAME_CHANGE”: Name change confirmation.
“UTILITY_BILL”: Regulated utility bill, such as electricity, gas, etc.
“BANK_STATEMENT”: Bank/card statement.
“BANK_ACCOUNT”: Bank account.
“INTENT_PROOF”: Proof of intent, generally a photo/video or a scanned letter.
“ATTESTATION”: Document of attestation (e.g., Statutory Declaration).

NOTE: These cannot be used as a supporting document:

“SELF_IMAGE”: A “selfie” used for comparisons.
“DEVICE”: Device ID.
“VEHICLE_REGISTRATION”: Vehicle registration number.
“PROOF_OF_ADDRESS”: Any document that provides proof of address.
“HOUSE_REGISTRATION”: House registration document.
“YELLOW_HOUSE_REGISTRATION”: Yellow House Registration Thor Ror 13.
“WORK_PERMIT”: Work permit.
“EMPLOYMENT_CERTIFICATE”: Certificate of employment.
“NOTARY_PUBLIC_ID”: Notary Public Identification.

Business-related documentation:

“EXTERNAL_ADMIN”: Details of appointed administrator.
“CHARGES”: Details of any charges laid against a company or director.
“PRE_ASIC”: Any documents that are Pre-ASIC.
“ANNUAL_RETURN”: Details of a company’s annual return.
“REPORT”: Frankie-generated report.
“TRUST_DEED”: Corporate trust deed.
“PARTNERSHIP_AGREEMENT”: Partnership agreement documents.
“ADMIN_CHANGE”: Change of administrator.
“COMPANY_REPORT”: Registry-filed company reports.

Special document types:

“CHECK_RESULTS”: Special document type for specifying results of checks completed other than through Frankie.
“AVIATION_SECURITY_ID”: Aviation Security Identification Card.
“MARITIME_SECURITY_ID”: Maritime Security Identification Card.

1	import requests
2
3	url = "https://api.uat.frankie.one/v2/individuals/entityId/documents/documentId"
4
5	headers = {
6	"api_key": "<apiKey>",
7	"X-Frankie-CustomerID": "12345678-1234-1234-1234-123456789012"
8	}
9
10	response = requests.get(url, headers=headers)
11
12	print(response.json())

1	{
2	"type": "OTHER",
3	"country": "AUS",
4	"documentId": "92de15f64-5717-4562-b3fc-2c963f6665a7",
5	"entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
6	"expiryDate": {
7	"day": "27",
8	"month": "03",
9	"normalized": "1990-03-31",
10	"type": "GREGORIAN",
11	"unstructured": "12 Rajab 1445 AH",
12	"year": "1990"
13	},
14	"issueDate": {
15	"day": "27",
16	"month": "03",
17	"normalized": "1990-03-31",
18	"type": "GREGORIAN",
19	"unstructured": "12 Rajab 1445 AH",
20	"year": "1990"
21	},
22	"primaryIdentifier": "000734130",
23	"secondaryIdentifier": "P0001975",
24	"subtype": "Photo Comparison",
25	"subdivision": "VIC",
26	"createdAt": "2024-01-15T02:18:11.365Z",
27	"updatedAt": "2025-01-16T02:18:11.365Z",
28	"validFrom": {
29	"day": "27",
30	"month": "03",
31	"normalized": "1990-03-31",
32	"type": "GREGORIAN",
33	"unstructured": "12 Rajab 1445 AH",
34	"year": "1990"
35	},
36	"validTo": {
37	"day": "27",
38	"month": "03",
39	"normalized": "1990-03-31",
40	"type": "GREGORIAN",
41	"unstructured": "12 Rajab 1445 AH",
42	"year": "1990"
43	},
44	"sourceId": "324f15f64-5717-4562-b3fc-2c963f66ffa1",
45	"supplementaryData": {
46	"type": "NATIONAL_HEALTH_ID",
47	"middleNameOnCard": "string",
48	"nameOnCardLine1": "string",
49	"nameOnCardLine2": "string",
50	"nameOnCardLine3": "string",
51	"nameOnCardLine4": "string",
52	"reference": "1"
53	},
54	"customAttributes": {},
55	"attachments": [
56	{
57	"data": {
58	"uri": "https://s3.amazonaws.com/dev/41963bc5feff322020137de233c3be0fac6/croppedFrontID/38d54232-b840-431d-b248-152345fe214.jpg"
59	},
60	"attachmentId": "string",
61	"sourceId": "string",
62	"createdAt": "2024-01-15T09:30:00Z",
63	"updatedAt": "2024-01-15T09:30:00Z",
64	"filename": "string",
65	"mimeType": "string",
66	"pageNumber": 1,
67	"side": "FRONT",
68	"type": "string",
69	"location": "string",
70	"lastMalwareScanAt": "2024-01-15T09:30:00Z",
71	"retrievalStatus": "NORMAL"
72	}
73	]
74	}