openapi: 3.1.0 info: version: v1 title: Reports description: "- **[AVM/PDF](https://developer.proptrack.com.au/docs/apis/reports/operations/get-a-api-v-1-report-valuation-sale-pdf):\ \ GET /api/v1/reports/valuations/{valuationId}/pdf**
Generates a valuation report, based on a\ \ previous AVM request\n- **[Reports/Property](https://developer.proptrack.com.au/docs/apis/reports/operations/create-a-api-v-1-report-property):\ \ POST /api/v1/reports/property**
Generates a property report for a given property
\n
\n\ \n
\n
\n \n\ \ \n \n \n
\n \n Getting Started\n
\n \n \ \ Start your journey\n \n \n \n \n \n \n \n \n \ \ API References\n \n \n Explore our knowledge base\n \ \ \n \n \n\ \ \n \n \n \n \n Useful Docs\n \n \n \ \ Helpful resources\n \n \n \n \n \n \n \n \n Get in Touch\n \n\ \ \n Connect with us\n \n \n\ \ \n \n \n" termsOfService: https://developer.proptrack.com.au/docs/apis/terms-of-use contact: url: https://www.proptrack.com.au/contact-us email: https://www.proptrack.com.au/contact-us name: PropTrack servers: - url: https://data.proptrack.com paths: /api/v1/reports/valuations/{valuationId}/pdf: get: tags: - AVM Report summary: /api/v1/reports/valuations/{valuationId}/pdf description: "Generates a valuation report, based on a previous AVM request for '**origination**'\ \ requests for the `SALE` / `RENT` / `AVM Plus` / `AVM Pro` Requests.\n\n Note: **Enquiry**\ \ PDF requests are not supportive.\n Endpoint /api/v1/reports/valuations/sale/{valuationId}/pdf\ \ was **`deprecated`** in March 2025. \n " operationId: reports-valuations-pdf parameters: - name: Authorization in: header description: Provide your bearer token as a string, in the format `Bearer {access_token}` in the Authorization Header
Refer to [Authentication](https://developer.proptrack.com.au/docs/apis/authentication/operations/create-a-oauth-2-token) required: true schema: type: string examples: - Bearer eyJraWQiOiJiYWRmNzUyNC1jYzBkLTQ3YWUtYTAzMC02MjBlYTE3ZDNlZjMiLCJ0eXAiOiJKV1QiLCJhbGc default: Bearer {access_token} example: Bearer jyJraWQiOiJiYWRmKzUyNC1jYzBkLTQ9YWUtYTAzMC02MjBlYTE3ZDNlZjMiLCJ0eXAiO - name: valuationId in: path description: Unique valuation identifier, generated from an AVM response required: true schema: type: string examples: - 29930cff-49ec-4dc5-82a6-974d5f04300e responses: '200': description: "\n\n> #### Success (200)\n\n Sale PDF report:\n\n\n![AVM-Sale-PDF-Page-1.png](../assets/images/AVM-Sale-PDF-Page-1.png)\ \ \n \n\n\n--![AVM-Sale-PDF-Page-2.png](../assets/images/AVM-Sale-PDF-Page-2.png)\n\ \n\n\n-------------\n\n Rental PDF report:\n\n\n![AVM-Rental-PDF-Page-1.png](../assets/images/AVM-Rental-PDF-Page-1.png)\ \ \n \n\n\n--![AVM-Rental-PDF-Page-2.png](../assets/images/AVM-Rental-PDF-Page-2.png)\n\ \n\n\n--![AVM-Rental-PDF-Page-3.png](../assets/images/AVM-Rental-PDF-Page3.png)\n\ \n\n\n\n ---------\n\n\n AVM Plus PDF report:\n\n\n![AVM-Plus-PDF-Page-1.png](../assets/images/AVM-Plus-PDF-Page-1.png)\ \ \n \n\n\n--![AVM-Plus-PDF-Page-2.png](../assets/images/AVM-Plus-PDF-Page-2.png)\n\ \n\n\n--![AVM-Plus-PDF-Page-3.png](../assets/images/AVM-Plus-PDF-Page-3.png)\n\ \n\n\n\n--![AVM-Plus-PDF-Page-4.png](../assets/images/AVM-Plus-PDF-Page4.png)\n\ \n\n\n---------\n\n\n AVM Pro PDF report:\n\n\n![AVM-Pro-PDF-Page-1.png](../assets/images/AVM-Pro-PDF-Page-1.png)\ \ \n \n\n\n--![AVM-Pro-PDF-Page-2.png](../assets/images/AVM-Pro-PDF-Page-2.png)\n\ \n\n\n--![AVM-Pro-PDF-Page-3.png](../assets/images/AVM-Pro-PDF-Page-3.png)\n\ \n\n\n\n--![AVM-Pro-PDF-Page-4.png](../assets/images/AVM-Pro-PDF-Page-4.png)\n\ \n\n" headers: Content-Type: schema: const: application/pdf description: Media type of the resource X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '400': description: ' > #### Bad Request (400) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#avmsale) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: errorCode: const: 400 description: Numeric value that defines the type of error that has occurred errorLevel: enum: - CRITICAL - WARNING description: 'Defines the severity of the error
- If level is `CRITICAL` then a successful response will not be returned
' errorMessage: type: string description: Briefly describes the type of error that has occured examples: - 'Bad Request: There was a problem with your request, check your input and ensure request contains the correct value. Please contact PropTrack Support if you require assistance' errorDetails: type: array description: A set of parameters that are causing the error and the rule that was invoked items: type: string examples: - 'Invalid Valuation ID: 29930cff-49ec-4fd5-83a6974d5e04300e' errorId: type: string description: Unique identifier of the error format: uuid examples: - 55e17eea-8fd6-4575-8832-82ce9b9b5afd x-examples: Example 1: errors: - errorCode: 400 errorLevel: CRITICAL errorMessage: 'Bad Request: There was a problem with your request, check your input and ensure request contains the correct value. Please contact PropTrack Support if you require assistance' errorDetails: - propertyId must be integer value greater than 0 - The address is invalid and not able to be matched errorId: eab0ca7f-5a45-4f04-ad37-8e297661e979 headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '401': description: ' > #### Unauthorized (401) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#avmsale) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: enum: - 9012 - 9016 description: Numeric value that defines the type of error that has occurred level: enum: - CRITICAL - WARNING description: 'Defines the severity of the error
- If level is `CRITICAL` then a successful response will not be returned
- If level is `WARNING` then a successful response will be returned, but with a validation warning' description: type: string description: Briefly describes the type of error that has occured examples: - Authentication token validation has failed - Please ensure that a valid token authentication request has been completed before trying again x-examples: Example 1: errors: - code: 9012 level: CRITICAL description: Authentication token validation has failed - Please ensure that a valid Token Authentication Request has been completed before trying again examples: Invalid Token: value: errors: - code: 9012 level: CRITICAL description: Authentication token validation has failed - Please ensure that a valid token authentication request has been completed before trying again Expired Token: value: errors: - code: 9016 level: CRITICAL description: Authentication token has expired - Please ensure that a valid token authentication request has been completed before trying again headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '403': description: ' > #### Forbidden (403) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#avmsale) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: const: 9003 description: Defines the type of error that has occurred description: type: string description: Overview of the error that has occurred examples: - Access denied - Please contact our customer support team at support@proptrack.com for access to this endpoint required: - code - description x-examples: Example 1: errors: - code: 9003 description: Access denied - Please contact our customer support team at support@proptrack.com for access to this endpoint examples: Example 1: value: errors: - code: 9003 description: Access denied - Please contact our customer support team at support@proptrack.com for access to this endpoint headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '429': description: ' > #### Too Many Requests (429) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#avmsale) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: const: 9011 description: Numeric value that defines the type of error that has occurred level: const: CRITICAL description: 'Defines the severity of the error
Note: If level is `CRITICAL` then a successful response will not be returned' description: type: string description: Briefly describes the type of error that has occured examples: - Rate limit has been exceeded - Please try again shortly required: - code - level - description x-examples: Example 1: errors: - code: 9011 level: CRITICAL description: Rate limit has been exceeded - Please try again shortly examples: Example 1: value: errors: - code: 9011 level: CRITICAL description: Rate limit has been exceeded - Please try again shortly headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '500': description: ' > #### Internal Server Error (500) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#avmsale) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: errorCode: type: integer description: Numeric value that defines the type of error that has occurred errorLevel: const: CRITICAL description: 'Defines the severity of the error
- If level is `CRITICAL` then a successful response will not be returned
' errorMessage: type: string description: Briefly describes the type of error that has occured examples: - 'Internal Server Error: Sorry, due to an internal issue we are unable to complete this request. Please contact PropTrack Support if you require assistance' errorDetails: type: array description: A set of parameters that are causing the error and the rule that was invoked items: type: string examples: - Sorry but our internal server is not able to provide a response at this time errorId: type: string description: Unique identifier of the error format: uuid examples: - 55e17eea-8fd6-4575-8832-82ce9b9b5afd x-examples: Example 1: errors: - errorCode: 500 errorLevel: CRITICAL errorMessage: 'Internal Server Error: Sorry, due to an internal issue we are unable to complete this request. Please contact PropTrack Support if you require assistance' errorDetails: - Sorry but our internal server is not able to provide a response at this time errorId: eab0ca7f-5a45-4f04-ad37-8e297661e979 '504': description: ' > #### Gateway Timeout (504) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#avmsale) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: errorCode: type: integer description: Numeric value that defines the type of error that has occurred errorLevel: const: CRITICAL description: 'Defines the severity of the error
- If level is `CRITICAL` then a successful response will not be returned
' errorMessage: type: string description: Briefly describes the type of error that has occured examples: - 'Gateway Timeout: Sorry, due to an internal timeout issue we are unable to complete this request. Please contact PropTrack Support if you require assistance' errorDetails: type: array description: A set of parameters that are causing the error and the rule that was invoked items: type: string examples: - Sorry the Realtime AVM is currently timing out errorId: type: string description: Unique identifier of the error format: uuid examples: - 55e17eea-8fd6-4575-8832-82ce9b9b5afd x-examples: Example 1: errors: - errorCode: 504 errorLevel: CRITICAL errorMessage: 'Gateway Timeout: Sorry, due to an internal timeout issue we are unable to complete this request. Please contact PropTrack Support if you require assistance' errorDetails: - Sorry the Realtime AVM is currently timing out errorId: eab0ca7f-5a45-4f04-ad37-8e297661e979 servers: - url: https://data.proptrack.com x-stoplight: id: vofldnme05epo /api/v1/reports/property: post: summary: /api/v1/reports/property description: Generates a property report for a given property. operationId: reports-property-report requestBody: description: '' content: application/json: schema: type: object properties: propertyId: type: integer description: Unique identifier for a property configId: type: string description: Unique report configuration identifier, provided by PropTrack
Default is a standard PropTrack property report format: uuid expiresAt: type: string description: 'Date after which the report will expire
Default is 90 days from date of issue
Note: Maximum timeframe is 12 months
Format `YYYY-MM-DD`' meta: type: object description: 'Custom data or information displayed on a property report, available on a premium report only
Some examples may include: name, email or phone number (Contact us to discuss you requirements)' required: - propertyId x-examples: Example 1: propertyId: 1026185 responses: '201': description: ' > #### Created (201) A digital property report is successfully created and a property report URL is returned.' content: application/json: schema: type: object properties: reportUrl: type: string description: Link to the digital property report examples: - https://report.proptrack.com/r/00e7j158-b633-8874-ae81-9239f4w2f554 required: - reportUrl x-examples: Example 1: reportUrl: https://report.proptrack.com/r/00e7j158-b633-8874-ae81-9239f4w2f554 headers: Content-Type: schema: const: application/json description: Media type of the resource X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '400': description: ' > #### Bad Request (400) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#reportsproperty) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: enum: - 7002 - 7004 - 7005 - 7008 - 7010 description: Defines the type of error that has occurred examples: - 7010 description: type: string description: Overview of the error that has occurred examples: - An incorrect format has been included - Please ensure that the correct formatting has been used for all parameters parameters: type: object description: A set of parameters that are causing the error and the rule that was invoked properties: configId: type: string examples: - invalid format expiresAt: type: string examples: - invalid format propertyId: type: string examples: - is required required: - code - description x-examples: Example 1: errors: - code: 7002 description: An incorrect format has been included - Please ensure that the correct formatting has been used for all parameters parameters: configId: invalid format expiresAt: invalid format propertyId: is required examples: Response Example: value: errors: - code: 7010 description: An incorrect format has been included - Please ensure that the correct formatting has been used for all parameters parameters: configId: invalid format expiresAt: invalid format headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '401': description: ' > #### Unauthorized (401) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#reportsproperty) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: description: Defines the type of error that has occurred examples: - UNAUTHORIZED description: type: string description: Overview of the error that has occurred examples: - Unauthorized required: - code - description x-examples: Example 1: errors: - code: UNAUTHORIZED description: Unauthorized headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '403': description: ' > #### Forbidden (403) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#reportsproperty) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: const: 9003 description: Defines the type of error that has occurred examples: - 9003 description: type: string description: Overview of the error that has occurred examples: - Access denied - Please contact our customer support team at support@proptrack.com for access to this endpoint headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '404': description: ' > #### Not Found (404) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#reportsproperty) for information on error handling.' content: application/json: schema: type: object properties: errors: type: object properties: code: const: 7001 description: Defines the type of error that has occurred examples: - 7001 description: type: string description: Overview of the error that has occurred examples: - The value does not match a record within our system parameters: type: object description: A set of parameters that are causing the error and the rule that was invoked properties: configId: type: string examples: - unknown value propertyId: type: string examples: - unknown value required: - code - description x-examples: Example 1: errors: code: 7001 description: The value does not match a record within our system parameters: configId: unknown value propertyId: unknown value headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '429': description: ' > #### Too Many Requests (429) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#reportsproperty) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: const: 9011 description: Defines the type of error that has occurred examples: - 9011 level: const: CRITICAL description: 'Defines the severity of the error
Note: If level is `CRITICAL` then a successful response will not be returned' x-deprecated: true description: type: string description: Overview of the error that has occurred examples: - Rate limit has been exceeded - Please try again shortly required: - code - description x-examples: Example 1: errors: - code: 9011 level: CRITICAL description: Rate limit has been exceeded - Please try again shortly headers: X-Transaction-Id: schema: type: string example: bxxe12cb-a6a8-4cad-9a8c-4f1d8abfa0d9 description: Should be quoted as a reference for any support request/unexpected error '500': description: ' > #### Internal Server Error (500) Refer to [Status Codes & Error Handling](https://developer.proptrack.com.au/docs/apis/error-handling#reportsproperty) for information on error handling.' content: application/json: schema: type: object properties: errors: type: array items: type: object properties: code: const: 9000 description: Defines the type of error that has occurred description: type: string description: Overview of the error that has occurred examples: - An internal server error has occurred and the requested data cannot be returned at this time x-examples: Example 1: errors: - code: 7000 description: An internal server error has occurred and the requested data cannot be returned at this time servers: - url: https://data.proptrack.com tags: - Property Report parameters: - name: Authorization in: header description: Provide your bearer token as a string, in the format `Bearer {access_token}` in the Authorization Header
Refer to [Authentication](https://developer.proptrack.com.au/docs/apis/authentication/operations/create-a-oauth-2-token) required: true schema: type: string examples: - Bearer eyJraWQiOiJiYWRmNzUyNC1jYzBkLTQ3YWUtYTAzMC02MjBlYTE3ZDNlZjMiLCJ0eXAiOiJKV1QiLCJhbGc default: Bearer {access_token} example: Bearer jyJraWQiOiJiYWRmKzUyNC1jYzBkLTQ9YWUtYTAzMC02MjBlYTE3ZDNlZjMiLCJ0eXAiO