> ## Documentation Index > Fetch the complete documentation index at: https://docs.argyle.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve A Report > Retrieves a report object. ## OpenAPI ````yaml get /v2/reports/{id} openapi: 3.0.0 info: title: Reports API version: v2 description: > Generate PDF summaries based on Argyle's data sets. Before generating a report: - To ensure full data availability, we recommend subscribing to the `reports.ready` webhook, which is sent when sufficient data has been retrieved to generate a verification report. - Depending on the data retrieval speed limits of the underlying payroll platform, it can take from a few seconds up to several minutes after a new account connection before enough data has been synced to generate a complete report. - Visit the [data availability](/api-guide/overview#data-availability) section of our API Guide for more information on the timing of data retrieval. After generating a report: - A new report object is created. Its `file_url` property contains a link to the PDF report, and the `accounts` array lists which accounts were used to generate the report. - The PDF report will also appear and can be downloaded within Console. Example reports: - [Verification of Employment](https://res.cloudinary.com/argyle-media/image/upload/v1726586839/docs-2024/voe-example.pdf) (PDF) - [Verification of Income and Employment](https://res.cloudinary.com/argyle-media/image/upload/v1726586839/docs-2024/voie-example.pdf) (PDF) servers: [] security: - basicAuth: [] paths: /v2/reports/{id}: get: summary: Retrieve a report description: Retrieves a report object. parameters: - name: id in: path required: true schema: type: string format: uuid description: ID of the report object to be retrieved. responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/Report' example: id: 43a2c6c3-1e63-91e5-88e3-f9ab2dcc489b user: 018051aa-f7a9-a0db-2f38-6cfa325e9d69 reference_id: 43a2c6c3-1e63-91e5-88e3-f9ab2dcc489b generated_at: '2023-03-09T16:22:06.081Z' created_at: '2023-03-09T16:22:06.081Z' type: voie status: generated file_url: www.argyle.com/storagename/pdf json_url: www.argyle.com/storagename/json last_synced_at: '2023-03-09T14:08:25.069Z' accounts: - id: 0187c66e-e7e5-811c-b006-2232f00f426a item: item_123456789 last_synced_at: '2023-03-09T14:08:25.069105Z' - id: 0185a8b8-60eb-80ca-7482-5f24504573f7 item: item_000000001 last_synced_at: '2023-03-01T05:10:59.558295Z' metadata: {} external_id: July_Connection components: schemas: Report: type: object example: id: 43a2c6c3-1e63-91e5-88e3-f9ab2dcc489b user: 018051aa-f7a9-a0db-2f38-6cfa325e9d69 reference_id: 43a2c6c3-1e63-91e5-88e3-f9ab2dcc489b generated_at: '2023-03-09T16:22:06.081Z' created_at: '2023-03-09T16:22:06.081Z' type: voie status: generated file_url: www.argyle.com/storagename/pdf json_url: www.argyle.com/storagename/json last_synced_at: '2023-03-09T14:08:25.069Z' accounts: - id: 0187c66e-e7e5-811c-b006-2232f00f426a item: item_123456789 last_synced_at: '2023-03-09T14:08:25.069105Z' - id: 0185a8b8-60eb-80ca-7482-5f24504573f7 item: item_000000001 last_synced_at: '2023-03-01T05:10:59.558295Z' metadata: {} external_id: July_Connection properties: id: type: string format: uuid description: | Unique ID of the report object. Also the "**Reference #**" on the report PDF. user: type: string format: uuid description: ID of the user associated with the report. reference_id: type: string format: uuid description: Report PDF identifier. deprecated: true generated_at: type: string format: date-time description: >- Timestamp ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) when the report was requested. deprecated: true created_at: type: string format: date-time description: >- Timestamp ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) when the report was requested. type: type: string enum: - voe - voie - voe-mortgage - voie-mortgage description: > The type of report. - `voie` - Verification of Income and Employment - `voe` - Verification of Employment - `voie-mortgage` - Verification of Income and Employment, integrated with Fannie Mae's Desktop Underwriter (DU) validation service and Freddie Mac's asset and income modeler (AIM) - `voe-mortgage` - Verification of Employment, integrated with Fannie Mae's Desktop Underwriter (DU) validation service and Freddie Mac's asset and income modeler (AIM) status: type: string enum: - waiting_for_sync - generating - generated - failed description: > Progress of report generation. - `waiting_for_sync`: Data from the connected payroll account is still being retrieved. - `generating`: The report is being generated. - `generated`: The report is ready to download. - `failed`: A system error occurred, preventing report generation. file_url: type: string description: > Download link to the report PDF. This static URL redirects to a download page that requires [Argyle authentication headers](/api-guide/overview#authentication). See the dropdown below for more information. Implementation requirements for client-side applications: json_url: type: string description: > Download link to the report in JSON. This static URL redirects to a download page that requires [Argyle authentication headers](/api-guide/overview#authentication). See the dropdown below for more information. last_synced_at: type: string format: date-time description: > Timestamp ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) when the account used to generate the report was last scanned for new data before the report was generated. If multiple accounts were used, the more recent timestamp. Used to populate the "Data as of" date on the report PDF. accounts: type: array items: type: object properties: id: type: string format: uuid description: ID of the account. item: type: string description: >- ID of the Item in Link through which the account was connected. last_synced_at: type: string format: date-time description: >- Timestamp ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) when the account was last scanned for new data before the report was generated. description: The accounts used to generate the report. metadata: type: object description: Any metadata for internal use added when generating the report. external_id: type: string description: >- The [external_id](/api-reference/users#object-external_id) of the user, otherwise `null`. securitySchemes: basicAuth: type: http scheme: basic description: Username = api_key_id, Password = api_key_secret ````