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 HeaderRefer 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\
\ \n \n\n\n--\n\
\n\n\n-------------\n\n Rental PDF report:\n\n\n\
\ \n \n\n\n--\n\
\n\n\n--\n\
\n\n\n\n ---------\n\n\n AVM Plus PDF report:\n\n\n\
\ \n \n\n\n--\n\
\n\n\n--\n\
\n\n\n\n--\n\
\n\n\n---------\n\n\n AVM Pro PDF report:\n\n\n\
\ \n \n\n\n--\n\
\n\n\n--\n\
\n\n\n\n--\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 PropTrackDefault
is a standard PropTrack property report
format: uuid
expiresAt:
type: string
description: 'Date after which the report will expireDefault is 90 days from date
of issueNote: Maximum timeframe is 12 monthsFormat `YYYY-MM-DD`'
meta:
type: object
description: 'Custom data or information displayed on a property report, available on
a premium report onlySome 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 errorNote: 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 HeaderRefer 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