{ "openapi": "3.0.1", "info": { "title": "Connect", "description": "All included utility endpoints for Basiq partners", "version": "3.0.0", "termsOfService": "https://docs.basiq.io/en/collections/440849-privacy-terms-and-common-questions", "license": { "name": "Commercial", "url": "https://basiq.io" } }, "servers": [ { "url": "https://au-api.basiq.io" } ], "paths": { "/token": { "post": { "tags": [ "Authentication" ], "summary": "Generate an auth token", "description": "Use this endpoint to retrieve a token that will be passed as authorization header for Basiq API", "operationId": "postToken", "parameters": [ { "name": "basiq-version", "in": "header", "required": true, "schema": { "type": "string", "example": "3.0" } } ], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "properties": { "scope": { "type": "string" }, "userId": { "type": "string" } } }, "examples": { "client_access": { "summary": "For all client side requests", "value": { "scope": "CLIENT_ACCESS", "userId": "6dd30ce4-d4ba-11ec-9d64-0242ac120002" } }, "server_access": { "summary": "For all server side requests", "value": { "scope": "SERVER_ACCESS" } } } } } }, "responses": { "200": { "description": "Return token object that will be used for Basiq API requests. ", "content": { "application/json": { "schema": { "required": [ "access_token", "expires_in", "token_type" ], "type": "object", "properties": { "access_token": { "type": "string", "description": "The generated access token.", "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" }, "expires_in": { "type": "integer", "description": "Expires in 3600 seconds", "format": "int64", "example": 3600 }, "token_type": { "type": "string", "description": "This value will always be `Bearer`.", "example": "Bearer" } }, "x-readme-ref-name": "TokenPostResponse" } } } }, "400": { "description": "Returns error that server cannot or will not process the request as it does not conform.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "api_key": [] } ] } }, "/users": { "post": { "tags": [ "Users" ], "summary": "Create a user", "description": "Creates a new Basiq user object", "operationId": "createUser", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "The end-users email address. Mandatory if mobile is not supplied.", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number, supplied in international format. +[country-code][mobileno]. Mandatory if email is not supplied.", "example": "+61410888999" }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Gavin" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Belson" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." } }, "x-readme-ref-name": "createUser" }, "examples": { "user": { "summary": "For All Users", "value": { "email": "gavin@hooli.com", "mobile": "+61410888666", "firstName": "Gavin", "middleName": "", "lastName": "Belson" } }, "Bcc": { "summary": "For Business Users", "value": { "email": "gavin@hooli.com", "mobile": "+61410888999", "firstName": "Gavin", "middleName": "middle name", "lastName": "Belson", "businessName": "Manly Accounting PTY LTD", "businessIdNo": "16 7645 892", "businessIdNoType": "ABN", "businessAddress": { "addressLine1": "21 Sydney Rd", "addressLine2": "", "suburb": "Manly", "state": "NSW", "postcode": "2095", "countryCode": "AUS" }, "verificationStatus": true, "verificationDate": "12/01/2024" } } } } }, "required": true }, "responses": { "201": { "description": "Returns the user object if the creation succeeded.", "content": { "application/json": { "schema": { "title": "UserPostResponse", "required": [ "id", "links", "mobile", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"user\".", "example": "user" }, "id": { "type": "string", "description": "A string that uniquely identifies the user.", "example": "e1956419" }, "email": { "type": "string", "description": "The end-users email address.", "format": "email", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number.", "example": 61410888999 }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Gavin" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Belson" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "User object with details if the creation succeeded.", "x-readme-ref-name": "UserPostResponse" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}": { "get": { "tags": [ "Users" ], "summary": "Retrieve a user", "description": "Retrieves the details of an existing user. You need only supply the unique user identifier that was returned upon user creation.", "operationId": "getUser", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user to be retrieved.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a user if a valid user ID was provided.", "content": { "application/json": { "schema": { "title": "UserGetResponse", "required": [ "accounts", "connections", "email", "id", "links", "mobile", "name", "firstName", "middleName", "lastName", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"user\".", "example": "user" }, "id": { "type": "string", "description": "User identification.", "example": "ea3a81" }, "email": { "type": "string", "description": "User email or empty.", "format": "email", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "User mobile number, or empty.", "example": 61410888666 }, "name": { "type": "string", "description": "Name, or empty.", "example": "" }, "firstName": { "type": "string", "description": "firstName, or empty", "example": "Gavin" }, "middleName": { "type": "string", "description": "middleName, or empty", "example": "middleName" }, "lastName": { "type": "string", "description": "lastName, or empty", "example": "lastName" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." }, "connections": { "title": "UserGetConnection", "required": [ "count", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of accounts.", "format": "int64", "example": 5 }, "data": { "type": "array", "description": "Connections data.", "items": { "title": "GetUserConnectionData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"connection\".", "example": "connection" }, "id": { "type": "string", "description": "Connection identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing connection data.", "x-readme-ref-name": "GetUserConnectionData" } } }, "description": "Container object containing connection data.", "x-readme-ref-name": "GetUserConnection" }, "accounts": { "title": "UserGetAccount", "required": [ "count", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of accounts.", "format": "int64", "example": 7 }, "data": { "type": "array", "description": "Accounts data.", "items": { "title": "UserGetAccountData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Account identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing account data.", "x-readme-ref-name": "GetUserAccountData" } } }, "description": "Container object containing account data.", "x-readme-ref-name": "GetUserAccount" }, "links": { "title": "GetUserLinks", "required": [ "accounts", "auth_link", "connections", "self", "transactions" ], "type": "object", "properties": { "accounts": { "type": "string", "description": "Accounts reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/accounts" }, "connections": { "type": "string", "description": "Connections reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/connections" }, "self": { "type": "string", "description": "User self reference url.", "example": "https://au-api.basiq.io/user/a3dgf4567a89" }, "transactions": { "type": "string", "description": "Transactions reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/transactions" } }, "description": "Object containing links to resources.", "x-readme-ref-name": "GetUserLinks" } }, "description": "User object with details if the creation succeeded.", "x-readme-ref-name": "UserGetResponse" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] }, "post": { "tags": [ "Users" ], "summary": "Update a user", "description": "Updates the specified user by setting the values of the parameters passed. Any parameters not provided will be left unchanged.", "operationId": "updateUser", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user to be retrieved.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "The end-users email address.", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number.", "example": "+61410888666" }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Malcolm" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "Malcom middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Malcolm last name" } }, "x-readme-ref-name": "updateUser" } } }, "required": true }, "responses": { "200": { "description": "Returns the user object if the update succeeded.", "content": { "application/json": { "schema": { "title": "UserPostResponse", "required": [ "id", "links", "mobile", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"user\".", "example": "user" }, "id": { "type": "string", "description": "A string that uniquely identifies the user.", "example": "e1956419" }, "email": { "type": "string", "description": "The end-users email address.", "format": "email", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number.", "example": 61410888999 }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Gavin" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Belson" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "User object with details if the creation succeeded.", "x-readme-ref-name": "UserPostResponse" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] }, "delete": { "tags": [ "Users" ], "summary": "Delete a user", "description": "Permanently deletes a user along with all of their associated connection details. All data associated with this user will deleted. You need only supply the unique user identifier that was returned upon user creation.", "operationId": "deleteUser", "parameters": [ { "name": "userId", "in": "path", "description": "User identification.", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Deletion succeeded.", "content": {} }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/consents": { "get": { "tags": [ "Consents" ], "summary": "Retrieve consents", "description": "Retrieves a list of the user consents", "operationId": "getConsents", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a list of user consents if they exist.", "content": { "application/json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "example": "list" }, "size": { "type": "integer", "example": 2 }, "data": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string" }, "id": { "type": "string", "format": "uuid" }, "created": { "type": "string", "format": "date-time" }, "updated": { "type": "string", "format": "date-time" }, "expiryDate": { "type": "string", "format": "date-time" }, "origin": { "type": "string" }, "status": { "type": "string", "description": "active, revoked, and expired" }, "purpose": { "type": "object", "additionalProperties": false, "properties": { "primary": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" }, "other": { "type": "boolean", "nullable": true } }, "required": [ "primary" ], "title": "Purpose", "x-readme-ref-name": "Purpose" }, "data": { "type": "object", "additionalProperties": false, "properties": { "retainData": { "type": "boolean" }, "initialRetrievalDays": { "type": "integer" }, "organisation": { "type": "boolean", "nullable": true }, "permissions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "scope": { "type": "string" }, "required": { "type": "boolean" }, "consented": { "type": "boolean" }, "entity": { "type": "string" }, "information": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "attributeList": { "type": "array", "items": { "type": "string" } } }, "required": [ "attributeList", "description", "name" ], "title": "Information", "x-readme-ref-name": "Information" }, "purpose": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" } }, "required": [ "entity", "information", "purpose", "required", "scope" ], "title": "Permission", "x-readme-ref-name": "Permission" } } }, "required": [ "permissions", "retainData" ], "title": "Data", "x-readme-ref-name": "Data" }, "revoked": { "type": "string", "description": "To indicate when a user consent was revoked." }, "links": { "type": "object", "properties": { "self": { "type": "string" }, "consentPolicy": { "type": "string" }, "latestConsentPolicy": { "type": "string" } } } }, "required": [ "created", "data", "expiryDate", "id", "purpose", "status", "type", "updated" ], "title": "UserConsentGetResponse", "x-readme-ref-name": "UserConsentGetResponses" } }, "links": { "type": "object", "properties": { "self": { "type": "string", "example": "https://au-api.basiq.io/users/79ce620b-e7a6-4d49-8053-e5a0acfbbb77/consents" } } } } }, "example": { "type": "list", "size": 2, "data": [ { "type": "consent", "id": "69d00245-1048-471a-902b-6cdc5d3d07a7", "created": "2024-09-26T12:12:01Z", "updated": "2024-09-26T12:12:01Z", "expiryDate": "2025-09-26T12:12:01Z", "origin": "user", "status": "active", "purpose": { "primary": { "title": "Share your financial data", "description": "We need to connect to your bank to collect some information about your finances" }, "other": null }, "data": { "retainData": true, "initialRetrievalDays": 730, "organisation": null, "permissions": [ { "scope": "account.basic", "required": true, "consented": true, "entity": "account", "information": { "name": "Account name, type and balance", "description": "This allows access to a list of your accounts and their current balance.", "attributeList": [ "Name of account", "Type of account", "Account balance" ] }, "purpose": { "title": "Account name, type and balance", "description": "We need to capture your list of accounts." } }, { "scope": "customer.person.detail", "required": true, "consented": true, "entity": "connection", "information": { "name": "Name, occupation, contact details", "description": "This allows access to personally identifiable information. Specifically your name, occupation, address(es) and contact details.", "attributeList": [ "Name", "Occupation", "Phone", "Email address", "Mail address", "Residential address" ] }, "purpose": { "title": "Name, occupation, contact details", "description": "This allows access to personally identifiable information." } }, { "scope": "transaction.detail", "required": true, "consented": true, "entity": "transaction", "information": { "name": "Transaction details", "description": "This allows access to transaction data for your accounts.", "attributeList": [ "Incoming and outgoing transactions", "Amounts", "Dates", "Descriptions of transactions", "Who you have sent money to and received money from" ] }, "purpose": { "title": "Transaction details", "description": "This allows access to transaction data for your accounts." } }, { "scope": "account.detail", "required": true, "consented": true, "entity": "account", "information": { "name": "Account balance and details", "description": "This allows access to detailed information of your accounts.", "attributeList": [ "Name of account", "Type of account", "Account balance", "Account number", "Interest rates", "Fees", "Discounts", "Account terms", "Account mail address" ] }, "purpose": { "title": "Account balance and details", "description": "We need to capture your account details." } } ] }, "links": { "self": "https://au-api.basiq.io/users/79ce620b-e7a6-4d49-8053-e5a0acfbbb77/consents/69d00245-1048-471a-902b-6cdc5d3d07a7", "consentPolicy": "https://au-api.basiq.io/policies/94c17e2f-c452-442d-b097-37064447fddd", "latestConsentPolicy": "https://au-api.basiq.io/policies/94c17e2f-c452-442d-b097-37064447fddd" } }, { "type": "consent", "id": "cd3a0120-e1d3-4646-ac49-70e4a2b13dfb", "created": "2024-03-08T14:32:06Z", "updated": "2024-09-24T12:19:35Z", "expiryDate": "2025-03-08T14:32:06Z", "origin": "user", "status": "revoked", "purpose": { "primary": { "title": "Share your financial data", "description": "We need to connect to your bank to collect some information about your finances" }, "other": null }, "data": { "retainData": true, "initialRetrievalDays": 730, "organisation": null, "permissions": [ { "scope": "account.basic", "required": true, "consented": true, "entity": "account", "information": { "name": "Account name, type and balance", "description": "This allows access to a list of your accounts and their current balance.", "attributeList": [ "Name of account", "Type of account", "Account balance" ] }, "purpose": { "title": "Account name, type and balance", "description": "We need to capture your list of accounts." } }, { "scope": "customer.person.detail", "required": true, "consented": true, "entity": "connection", "information": { "name": "Name, occupation, contact details", "description": "This allows access to personally identifiable information.", "attributeList": [ "Name", "Occupation", "Phone", "Email address", "Mail address", "Residential address" ] }, "purpose": { "title": "Name, occupation, contact details", "description": "This allows access to personally identifiable information." } }, { "scope": "transaction.detail", "required": true, "consented": true, "entity": "transaction", "information": { "name": "Transaction details", "description": "This allows access to transaction data for your accounts.", "attributeList": [ "Incoming and outgoing transactions", "Amounts", "Dates", "Descriptions of transactions", "Who you have sent money to and received money from" ] }, "purpose": { "title": "Transaction details", "description": "This allows access to transaction data for your accounts." } }, { "scope": "account.detail", "required": true, "consented": true, "entity": "account", "information": { "name": "Account balance and details", "description": "This allows access to detailed information of your accounts.", "attributeList": [ "Name of account", "Type of account", "Account balance", "Account number", "Interest rates", "Fees", "Discounts", "Account terms", "Account mail address" ] }, "purpose": { "title": "Account numbers and features", "description": "We need to capture your account details." } } ] }, "revoked": "2024-09-24T12:19:35Z", "links": { "self": "https://au-api.basiq.io/users/79ce620b-e7a6-4d49-8053-e5a0acfbbb77/consents/cd3a0120-e1d3-4646-ac49-70e4a2b13dfb", "consentPolicy": "https://au-api.basiq.io/policies/0c89969d-48e9-4dae-9525-9613efb13338", "latestConsentPolicy": "https://au-api.basiq.io/policies/94c17e2f-c452-442d-b097-37064447fddd" } } ] } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/consents/{consentId}": { "delete": { "tags": [ "Consents" ], "summary": "Delete a consent", "description": "Permanently deletes a users consent, this action cannot be undone.", "operationId": "deleteConsent", "parameters": [ { "name": "userId", "in": "path", "description": "User identification.", "required": true, "schema": { "type": "string" } }, { "name": "consentId", "in": "path", "description": "Consent identification.", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Deletion succeeded.", "content": {} }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/connections": { "get": { "tags": [ "Connections" ], "summary": "List all connections", "description": "Returns a list of connections belonging to this user. Each entry in the array is a separate object. If no data is returned, the resulting array will be empty.", "operationId": "getConnections", "parameters": [ { "name": "userId", "in": "path", "description": "User identifier.", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Connections filters, id, status, institution.id. e.g institution.id.eq('AU00000')", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns details of connections.", "content": { "application/json": { "schema": { "title": "ConnectionsGetResponseResource", "required": [ "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"list\".", "example": "list" }, "data": { "type": "array", "items": { "required": [ "createdDate", "expiryDate", "id", "method", "institution", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"connection\".", "example": "connection" }, "id": { "type": "string", "description": "Connection identification.", "example": "61723" }, "method": { "type": "string", "description": "method identification.", "example": "openbanking" }, "status": { "type": "string", "description": "Connection status, available only for SERVER_SCOPE.", "example": "active", "enum": [ "active", "pending", "invalid", "pre-init" ] }, "createdDate": { "type": "string", "description": "Created date of the connection, available only for SERVER_SCOPE.", "example": "2019-07-29T07:34:09Z" }, "expiryDate": { "type": "string", "description": "Expiry date of the connection.This date is only set for open-banking connections. \n\nFor web connections, the expiry date field will be empty.\n", "example": "2020-07-29T07:34:09Z" }, "lastUsed": { "type": "string", "description": "Connection last used date, available only for SERVER_SCOPE.", "example": "2020-06-22T11:15:09Z" }, "institution": { "title": "ConnectionInstitution", "required": [ "id", "links", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "Institution id", "example": "AU00000" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" }, "type": { "type": "string", "description": "Always \"institution\".", "example": "institution" } }, "description": "Institution details.", "x-readme-ref-name": "ConnectionInstitution" }, "links": { "title": "GetConnectionsLinks", "required": [ "institution", "self" ], "type": "object", "properties": { "accounts": { "type": "string", "description": "Accounts reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts?filter=institution.id.eq('AU00000')" }, "institution": { "type": "string", "description": "Institution details.", "example": "https://au-api.basiq.io/institutions/AU00000" }, "self": { "type": "string", "description": "Connection self reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92/connections/29523951" }, "transactions": { "type": "string", "description": "Transactions reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92/transactions?filter=institution.id.eq('AU00000')" } }, "description": "Object containing links to resources.", "x-readme-ref-name": "GetConnectionsLinks" } }, "x-readme-ref-name": "ConnectionsData" } }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing details for connections.", "x-readme-ref-name": "ConnectionsGetResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" }, "examples": { "Bad Request": { "value": { "type": "list", "correlationId": "ac5ah5i", "data": [ { "type": "error", "title": "Parameter not valid.", "code": "parameter-not-valid", "detail": "ID value is not valid.", "source": { "parameter": "id" } } ] } }, "Invalid Filters": { "value": { "type": "list", "correlationId": "ac5ah55", "data": [ { "type": "error", "code": "parameter-not-valid", "title": "Parameter value is not valid", "detail": "The provided filter parameter is in invalid format or unsupported", "source": { "parameter": "filter" } } ] } } } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/connections/refresh": { "post": { "tags": [ "Connections" ], "summary": "Refresh all connections", "description": "Use this to refresh all connections belonging to the specified user.", "operationId": "refreshConnections", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user.", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "Returns a created jobs resource, if the operation succeeded.", "content": { "application/json": { "schema": { "title": "ConnectionsRefreshResource", "required": [ "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"list\".", "example": "list" }, "data": { "type": "array", "description": "Job details data.", "items": { "title": "ConnectionResponseResource", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"job\".", "example": "job" }, "id": { "type": "string", "description": "Job identification.", "example": "29523951" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing details for connection post.", "x-readme-ref-name": "ConnectionResponseResource" } } }, "description": "Object containing details for connections refresh.", "x-readme-ref-name": "ConnectionsRefreshResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/connections/{connectionId}": { "get": { "tags": [ "Connections" ], "summary": "Retrieve a connection", "description": "Use this to retrieve details of a specific connection. Note that due to security the loginId, password, securityCode are never returned.", "operationId": "getConnection", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user.", "required": true, "schema": { "type": "string" } }, { "name": "connectionId", "in": "path", "description": "The identifier of the connection.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns details of a connection.", "content": { "application/json": { "schema": { "title": "ConnectionGetResponseResource", "required": [ "createdDate", "expiryDate", "method", "id", "institution", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"connection\".", "example": "connection" }, "id": { "type": "string", "description": "A string that uniquely identifies the user connection.", "example": "61723" }, "method": { "type": "string", "description": "A string that uniquely identifies the user connections either it is web or openbanking", "example": "open-banking" }, "createdDate": { "type": "string", "description": "Created date of the connection, available only for SERVER_SCOPE.", "example": "2019-07-29T07:34:09Z" }, "expiryDate": { "type": "string", "description": "Expiry date of the connection.This date is only set for open-banking connections. \n\nFor web connections, the expiry date field will be empty.\n", "example": "2020-07-29T07:34:09Z" }, "lastUsed": { "type": "string", "description": "UTC Date and Time of when the connection was last used, in RFC 3339 format, available only for SERVER_SCOPE.", "example": "2020-06-22T11:15:09Z" }, "accounts": { "required": [ "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type always \"list\".", "example": "list" }, "data": { "type": "array", "description": "Accounts details", "items": { "required": [ "type", "id", "lastUpdated", "accountNo", "availableFunds", "balance", "class", "currency", "links", "name", "status" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Account identification.", "example": "319ae910" }, "name": { "type": "string", "description": "Account name.", "example": "Business account" }, "currency": { "type": "string", "description": "Currency", "example": "AUD" }, "class": { "required": [ "type", "product" ], "properties": { "type": { "type": "string", "description": "Account type", "example": "mortgage" }, "product": { "type": "string", "description": "Product name.", "example": "Hooli Home Loan" } }, "x-readme-ref-name": "AccountClass" }, "accountNo": { "type": "string", "description": "Account number", "example": "105148119695" }, "availableFunds": { "type": "string", "description": "Account available funds, nullable.", "nullable": true, "example": "200.54" }, "balance": { "type": "string", "description": "Account balance, nullable.", "nullable": true, "example": "100.12" }, "lastUpdated": { "type": "string", "description": "Account last updated date and time.", "example": "2017-09-28T11:15:09.756Z" }, "status": { "type": "string", "description": "Account status.", "example": "available", "enum": [ "available", "unavailable" ] }, "links": { "required": [ "self", "transactions" ], "type": "object", "properties": { "transactions": { "type": "string", "description": "transactions link to the transactions associated with this account", "example": "https://au-api.basiq.io/users/ea3a81/transactions?filter=account.id.eq('s55bf3')" }, "self": { "type": "string", "description": "self link to the requested account", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" } }, "x-readme-ref-name": "ConnectionAccountLinks" } }, "x-readme-ref-name": "AccountsData" } } }, "x-readme-ref-name": "AccountsContainer" }, "institution": { "title": "ConnectionInstitution", "required": [ "id", "links", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "Institution id", "example": "AU00000" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" }, "type": { "type": "string", "description": "Always \"institution\".", "example": "institution" } }, "description": "Institution details.", "x-readme-ref-name": "ConnectionInstitution" }, "profile": { "required": [ "emailAddresses", "firstName", "fullName", "lastName", "middleName", "phoneNumbers", "physicalAddresses" ], "type": "object", "properties": { "emailAddresses": { "type": "array", "description": "User email address", "example": [ "gavin@hooli.com" ], "items": { "type": "string" } }, "firstName": { "type": "string", "description": "User first name", "example": "Gavin" }, "fullName": { "type": "string", "description": "User full name", "example": "Gavin Belson" }, "lastName": { "type": "string", "description": "User last name", "example": "Belson" }, "middleName": { "type": "string", "description": "User middle name" }, "phoneNumbers": { "type": "array", "description": "User phone number", "example": [ "XXXX 888 991" ], "items": { "type": "string" } }, "physicalAddresses": { "type": "array", "description": "Physical user addresses", "items": { "title": "PhysicalAddresses", "required": [ "addressLine1", "addressLine2", "addressLine3", "city", "countryCode", "formattedAddress", "postcode", "state" ], "type": "object", "properties": { "addressLine1": { "type": "string", "description": "User address.", "example": "13/91 Fisher Rd" }, "addressLine2": { "type": "string", "description": "Always \"null\"", "nullable": true }, "addressLine3": { "type": "string", "description": "Always \"null\"", "nullable": true }, "city": { "type": "string", "description": "City", "example": "Sydney" }, "country": { "type": "string" }, "countryCode": { "type": "string", "description": "Country code", "example": "AU" }, "formattedAddress": { "type": "string", "description": "Address formatted.", "example": "13/91 Fisher Rd, Dee Why NSW 2099, Australia" }, "postcode": { "type": "string", "description": "Post code", "example": "2099" }, "state": { "type": "string", "description": "State", "example": "NSW" } }, "description": "User physical addresses holding the connection.", "x-readme-ref-name": "PhysicalAddresses" } } }, "x-readme-ref-name": "ConnectionProfile" }, "status": { "type": "string", "description": "Indicates the connection status, available only for SERVER_SCOPE.", "example": "active", "enum": [ "active", "pending", "invalid", "pre-init" ] }, "links": { "title": "GetConnectionLinks", "required": [ "self", "user" ], "type": "object", "properties": { "accounts": { "type": "string", "description": "Accounts reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts?filter=institution.id.eq('AU00000')" }, "self": { "type": "string", "description": "Connection self reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92-0b12-43ba-a3c1-286dd5f4f396/connections/29523951" }, "transactions": { "type": "string", "description": "Transactions reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92/transactions?filter=institution.id.eq('AU00000')" }, "user": { "type": "string", "description": "User reference url.", "example": "https://au-api.basiq.io/users/cd6fbd92" } }, "description": "Object containing links to resources.", "x-readme-ref-name": "GetConnectionLinks" } }, "description": "Object containing details for connection post.", "x-readme-ref-name": "ConnectionGetResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] }, "delete": { "tags": [ "Connections" ], "summary": "Delete a connection", "description": "Permanently deletes a connection. This does not include the existing account and transaction data associated with it. This can not be undone.", "operationId": "deleteConnection", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user.", "required": true, "schema": { "type": "string" } }, { "name": "connectionId", "in": "path", "description": "The identifier of the connection.", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Returns an empty body if the delete succeeded.", "content": {} }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/connections/{connectionId}/refresh": { "post": { "tags": [ "Connections" ], "summary": "Refresh a connection", "description": "Use this to refresh an existing connection. This will not return a new connection. Instead will return a job resource which is resonsible for refreshing the connection and fetching data asynchronously. Use this job resource to track the connections progress.", "operationId": "refreshConnection", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user.", "required": true, "schema": { "type": "string" } }, { "name": "connectionId", "in": "path", "description": "The identifier of the connection.", "required": true, "schema": { "type": "string" } } ], "responses": { "202": { "description": "Returns a created job resource, if the operation succeeded.", "content": { "application/json": { "schema": { "title": "ConnectionResponseResource", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"job\".", "example": "job" }, "id": { "type": "string", "description": "Job identification.", "example": "29523951" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing details for connection post.", "x-readme-ref-name": "ConnectionResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/connections/{connectionId}/purge": { "post": { "tags": [ "Connections" ], "summary": "Purge connection data", "description": "Use this endpoint to remove all user data related to a specific institution. Purging is only applicable for active user connections.\n\nWhen Enrich data is updated, the Enrich results under transactions won’t automatically reflect these updates. To ensure the latest Enrich results are available, partners should first purge and then refresh connections. Without this step, any new insight reports generated will not include the latest enriched data.\n\n> 📘 **Note:** Remember to purge and refresh connections to keep Enrich insights current.", "operationId": "purgeConnectionData", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user.", "required": true, "schema": { "type": "string" } }, { "name": "connectionId", "in": "path", "description": "The identifier of the connection.", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "Returns an empty body if the delete succeeded.", "content": {} }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/jobs": { "get": { "tags": [ "Jobs" ], "summary": "Get user jobs", "description": "Retrieves the details of all existing and previous jobs associated with a user.\n\n**Note:** This endpoint only returns jobs that are less than 7 days old.\n", "operationId": "getUserJobs", "parameters": [ { "name": "userId", "in": "path", "description": "User identifier", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Connection identification filter. e.g. connection.id.eq('ab63cd')", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a list of jobs with details.", "content": { "application/json": { "schema": { "required": [ "data", "links", "size", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"list\".", "example": "list" }, "data": { "type": "array", "description": "Container object, containing job details.", "items": { "title": "JobsData", "required": [ "created", "id", "institution", "steps", "updated" ], "type": "object", "properties": { "type": { "type": "string", "description": "Value is \"job\".", "example": "job" }, "id": { "type": "string", "description": "A string that uniquely identifies the job.", "example": "e9132638" }, "created": { "type": "string", "description": "The date time when the job was created.", "example": "2020-06-10T09:59:00Z" }, "updated": { "type": "string", "description": "The date time when the job was last updated.", "example": "2020-06-10T09:59:00Z" }, "institution": { "title": "Institution", "required": [ "id", "links", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "A string that uniquely identifies institution.", "example": "AU00000" }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" }, "type": { "type": "string", "description": "Always \"institution\".", "example": "institution" } }, "description": "Institution details.", "x-readme-ref-name": "JobsInstitution" }, "steps": { "type": "array", "description": "List of steps that need to be completed.", "items": { "title": "JobsStep", "required": [ "result", "status" ], "type": "object", "properties": { "title": { "type": "string", "description": "Name of the step the job needs to complete.", "example": "retrieve-accounts", "enum": [ "verify-credentials", "retrieve-accounts", "retrieve-transactions", "retrieve-statements" ] }, "status": { "type": "string", "description": "Status of the job step", "example": "success", "enum": [ "pending", "in-progress", "success", "failed" ] }, "result": { "title": "JobsResult", "type": "object", "properties": { "code": { "type": "string", "description": "In case of failed job, displays error code.", "enum": [ "success", "user-action-required", "system-unavailable", "maintenance", "connector-error", "institution-not-found", "institution-not-available", "institution-disabled", "missing-required-field", "missing-required-field-value", "invalid-field-value", "invalid-csv-row", "row-count-exceeded", "account-data-differs", "empty-file", "bank-statement-invalid", "bank-statement-new-product", "bank-statement-parsing-error", "bank-statement-not-supported", "txn-after-last-updated-date", "invalid-connection", "unknown-error", "job-timed-out" ] }, "details": { "type": "string", "description": "In case of failed job, displays details of the error." }, "title": { "type": "string", "description": "In case of failed job, displays error title." }, "type": { "type": "string", "description": "In case of success, Always \"link\".", "example": "link" }, "url": { "type": "string", "description": "In case of success, URL of the updated (or created) resources." } }, "description": "Result object containing a list of URLs or null. Otherwise if a step failed contains an error response.", "x-readme-ref-name": "JobsResult" } }, "description": "List of steps that need to be completed.", "x-readme-ref-name": "JobsStep" } }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" } }, "description": "Container object, containing job details.", "x-readme-ref-name": "JobsData" } }, "size": { "type": "integer", "description": "Size of the all the jobs.", "format": "int64", "example": 100 }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "x-readme-ref-name": "JobsResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/jobs/{jobId}": { "get": { "tags": [ "Jobs" ], "summary": "Retrieve a job", "description": "Retrieves the details of an existing job. You need only supply the unique job identifier that was returned upon job creation.", "operationId": "getJobs", "parameters": [ { "name": "jobId", "in": "path", "description": "The identifier of the job to be retrieved.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a job details if a valid job ID was provided.", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "partnerId": { "type": "string" }, "status": { "type": "string" }, "jobType": { "type": "string" }, "applicationId": { "type": "string" }, "created": { "description": "date and time in ISO format of when the job request was created", "type": "string", "format": "date-time" }, "updated": { "description": "date and time in ISO format of when the job request was updated", "type": "string", "format": "date-time" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "result": { "type": "object", "nullable": true, "properties": { "type": { "type": "string" }, "url": { "type": "string" }, "code": { "type": "string" }, "title": { "type": "string" }, "detail": { "type": "string" } } } } } }, "links": { "type": "object", "properties": { "link": { "type": "string" }, "self": { "type": "string" }, "source": { "type": "string" } } } }, "x-readme-ref-name": "job" }, { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "createdDate": { "description": "date and time in ISO format of when the job request was created", "type": "string", "format": "date-time" }, "updatedDate": { "description": "date and time in ISO format of when the job request was updated", "type": "string", "format": "date-time" }, "jobType": { "type": "string" }, "sourceId": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "result": { "type": "object", "nullable": true, "properties": { "type": { "type": "string" }, "url": { "type": "string" } } } } } }, "links": { "type": "object", "properties": { "link": { "type": "string" }, "self": { "type": "string" }, "source": { "type": "string" } } } }, "x-readme-ref-name": "StatementJobs" }, { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "partnerId": { "type": "string" }, "applicationId": { "type": "string" }, "created": { "type": "string" }, "updated": { "type": "string" }, "status": { "type": "string" }, "jobType": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "result": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "type": "string" } } } } } }, "links": { "type": "object", "properties": { "self": { "type": "string" }, "source": { "type": "string" } } } }, "x-readme-ref-name": "ReportsJob" } ] }, "examples": { "data-in-progress": { "value": { "type": "job", "id": "248b2883-2a6b-4e8a-9591-76565d23ba5a", "created": "2024-09-25T04:15:59Z", "updated": "2024-09-25T04:15:59Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "in-progress", "result": null }, { "title": "retrieve-accounts", "status": "pending", "result": null }, { "title": "retrieve-transactions", "status": "pending", "result": null } ], "links": { "self": "https://au-api.basiq.io/jobs/248b2883-2a6b-4e8a-9591-76565d23ba5a" } } }, "data-failed": { "value": { "type": "job", "id": "5c50a2d1-561c-48c4-a186-b763bdf5502a", "created": "2024-09-25T04:22:25Z", "updated": "2024-09-25T04:22:38Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "failed", "result": { "code": "authorization-failed", "title": "Authorization failed", "detail": "access_denied" } }, { "title": "retrieve-accounts", "status": "pending", "result": null }, { "title": "retrieve-transactions", "status": "pending", "result": null } ], "links": { "self": "https://au-api.basiq.io/jobs/5c50a2d1-561c-48c4-a186-b763bdf5502a", "source": "https://au-api.basiq.io/users/b2afc9cd-0f3c-41f0-9e19-d18482abc9fc/connections/60612323-9c42-478a-8ff2-640445dbe64a" } } }, "data-success": { "value": { "type": "job", "id": "a03e4df4-dc05-4cd3-9af0-0f28a13ea614", "created": "2024-09-25T04:14:48Z", "updated": "2024-09-25T04:14:50Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "success", "result": { "type": "link", "url": "/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/connections/214974bb-56d6-466a-9034-ba0a6b810eed" } }, { "title": "retrieve-accounts", "status": "success", "result": { "type": "link", "url": "/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/accounts?filter=institution.id.eq('AU00000')" } }, { "title": "retrieve-transactions", "status": "success", "result": { "type": "link", "url": "/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/transactions?filter=institution.id.eq('AU00000')" } } ], "links": { "self": "https://au-api.basiq.io/jobs/a03e4df4-dc05-4cd3-9af0-0f28a13ea614", "source": "https://au-api.basiq.io/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/connections/214974bb-56d6-466a-9034-ba0a6b810eed" } } }, "statement-in-progress": { "value": { "type": "job", "id": "248b2883-2a6b-4e8a-9591-76565d23ba5a", "created": "2024-09-25T04:15:59Z", "updated": "2024-09-25T04:15:59Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "in-progress", "result": null }, { "title": "retrieve-accounts", "status": "pending", "result": null }, { "title": "retrieve-transactions", "status": "pending", "result": null } ], "links": { "self": "https://au-api.basiq.io/jobs/248b2883-2a6b-4e8a-9591-76565d23ba5a" } } }, "statement-failed": { "value": { "type": "job", "id": "f14de1bb-ddbe-4c16-add0-efab65aab13d", "created": "2024-09-25T04:28:59Z", "updated": "2024-09-25T04:29:09Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "failed", "result": { "code": "bank-statement-not-supported", "title": "Statement not supported.", "detail": "Statement is not currently supported for this institution - check statement uploaded against correct bank." } }, { "title": "retrieve-accounts", "status": "pending", "result": null }, { "title": "retrieve-transactions", "status": "pending", "result": null } ], "links": { "self": "https://au-api.basiq.io/jobs/f14de1bb-ddbe-4c16-add0-efab65aab13d" } } }, "statement-success": { "value": { "type": "job", "id": "248b2883-2a6b-4e8a-9591-76565d23ba5a", "created": "2024-09-25T04:15:59Z", "updated": "2024-09-25T04:16:29Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "success", "result": { "type": "link", "url": "/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/connections/30dfc31c-7107-40a4-bd94-237554726a4d" } }, { "title": "retrieve-accounts", "status": "success", "result": { "type": "link", "url": "/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/accounts?filter=institution.id.eq('AU00601')" } }, { "title": "retrieve-transactions", "status": "success", "result": { "type": "link", "url": "/users/b540e803-91dd-4ff9-a89e-ef8ecf65833d/transactions?filter=institution.id.eq('AU00601')" } } ], "links": { "self": "https://au-api.basiq.io/jobs/248b2883-2a6b-4e8a-9591-76565d23ba5a" } } }, "Mygov-in-progress": { "value": { "type": "job", "id": "b4b51f7c-e5f0-4767-bc6f-0025a66bd4f9", "created": "2024-09-25T04:34:59Z", "updated": "2024-09-25T04:34:59Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "in-progress", "result": null }, { "title": "mfa-challenge", "status": "pending", "result": null }, { "title": "retrieve-accounts", "status": "pending", "result": null }, { "title": "retrieve-transactions", "status": "pending", "result": null }, { "title": "retrieve-statements", "status": "pending", "result": null } ], "links": { "self": "https://au-api.basiq.io/jobs/b4b51f7c-e5f0-4767-bc6f-0025a66bd4f9", "source": "https://au-api.basiq.io/users/bfa52043-e154-4adf-94d1-7f0544affc45/connections/05b14a4a-189a-412a-a8c3-88adf2fc47f4" } } }, "Mygov-failed": { "value": { "type": "job", "id": "57d6ab28-1fd4-4851-b9d2-81ca2884de21", "created": "2024-09-25T04:40:41Z", "updated": "2024-09-25T04:40:50Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "failed", "result": { "code": "invalid-credentials", "title": "Cannot login to target institution, check credentials.", "detail": "Cannot login to target institution using supplied credentials. Please check credentials and try again." } }, { "title": "mfa-challenge", "status": "pending", "result": null }, { "title": "retrieve-accounts", "status": "pending", "result": null }, { "title": "retrieve-transactions", "status": "pending", "result": null }, { "title": "retrieve-statements", "status": "pending", "result": null } ], "links": { "self": "https://au-api.basiq.io/jobs/57d6ab28-1fd4-4851-b9d2-81ca2884de21", "source": "https://au-api.basiq.io/users/bfa52043-e154-4adf-94d1-7f0544affc45/connections/326d43c0-b009-4dfc-a7d0-708e5160bde5" } } }, "Mygov-success": { "value": { "type": "job", "id": "cd6b8aac-53b3-408d-806e-34b9ef59459e", "created": "2024-09-25T04:44:38Z", "updated": "2024-09-25T04:46:00Z", "jobType": "connection", "steps": [ { "title": "verify-credentials", "status": "success", "result": { "type": "link", "url": "/users/bfa52043-e154-4adf-94d1-7f0544affc45/connections/67b38670-4aca-4e1d-a66e-3af4c56a35bc" } }, { "title": "mfa-challenge", "status": "success", "result": { "type": "mfa", "method": "token", "description": "A SMS code has been sent to your device, please enter valid number.", "input": [ "We sent a code by SMS to your mobile number XXXX XXX 178." ], "expiryMs": 120000, "links": { "response": "https://au-api.basiq.io/jobs/cd6b8aac-53b3-408d-806e-34b9ef59459e/mfa" } } }, { "title": "retrieve-accounts", "status": "success", "result": { "type": "link", "url": "/users/bfa52043-e154-4adf-94d1-7f0544affc45/accounts?filter=institution.id.eq('AU20700')" } }, { "title": "retrieve-transactions", "status": "success", "result": { "type": "link", "url": "/users/bfa52043-e154-4adf-94d1-7f0544affc45/transactions?filter=institution.id.eq('AU20700')" } }, { "title": "retrieve-statements", "status": "success", "result": { "type": "link", "url": "/users/bfa52043-e154-4adf-94d1-7f0544affc45/statements" } } ], "links": { "self": "https://au-api.basiq.io/jobs/cd6b8aac-53b3-408d-806e-34b9ef59459e", "source": "https://au-api.basiq.io/users/bfa52043-e154-4adf-94d1-7f0544affc45/connections/67b38670-4aca-4e1d-a66e-3af4c56a35bc" } } }, "Report-in-progress": { "value": { "type": "job", "id": "b1824ad0-73f1-0138-3700-0a58a9feac09", "partnerId": "e73ffa09-742f-4be3-9aae-0ad077f041a1", "applicationId": "3e2863df-43d1-405d-b104-701bcb34e184", "created": "2016-06-08T09:10:32.000Z", "updated": "2016-06-08T09:14:28.000Z", "status": "in-progress", "jobType": "report", "steps": [ { "title": "create-report", "status": "in-progress", "result": null } ], "links": { "self": "/jobs/b1824ad0-73f1-0138-3700-0a58a9feac09", "source": "/reports/b1824ad0-73f1-0138-3700-0a58a9feac09" } } }, "Report-failed": { "value": { "type": "job", "id": "b1824ad0-73f1-0138-3700-0a58a9feac09", "partnerId": "e73ffa09-742f-4be3-9aae-0ad077f041a1", "applicationId": "3e2863df-43d1-405d-b104-701bcb34e184", "created": "2016-06-08T09:10:32.000Z", "updated": "2016-06-08T09:14:28.000Z", "status": "failed", "jobType": "report", "steps": [ { "title": "create-report", "status": "failed", "result": null } ], "links": null } }, "Report-success": { "value": { "type": "job", "id": "b1824ad0-73f1-0138-3700-0a58a9feac09", "partnerId": "e73ffa09-742f-4be3-9aae-0ad077f041a1", "applicationId": "3e2863df-43d1-405d-b104-701bcb34e184", "created": "2016-06-08T09:10:32.000Z", "updated": "2016-06-08T09:14:28.000Z", "status": "success", "jobType": "report", "steps": [ { "title": "create-report", "status": "success", "result": { "type": "link", "url": "/reports/b1824ad0-73f1-0138-3700-0a58a9feac09" } } ], "links": { "self": "/jobs/b1824ad0-73f1-0138-3700-0a58a9feac09", "source": "/reports/b1824ad0-73f1-0138-3700-0a58a9feac09" } } } } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "invalid-credentials", "service-unavailable", "job-timed-out", "account-not-accessible-requires-user-action", "resource-not-found", "temporary-unavailable", "maintenance-error", "row-count-exceeded", "empty-file", "bank-statement-invalid", "bank-statement-new-product", "bank-statement-parsing-error", "bank-statement-not-supported", "statement-not-available", "temporary-unavailable-queued", "job-invalidated", "authorization-failed", "invalid-csv-row", "invalid-field-value", "missing-required-field", "missing-required-field-value", "account-data-differs" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/jobs/{jobId}/mfa": { "post": { "tags": [ "Jobs" ], "summary": "Create MFA response", "description": "Ensure that you generate an authentication token with\nscope = CLIENT_ACCESS and basiq-version = 3.0 to create this resource", "operationId": "postJobMfa", "parameters": [ { "name": "jobId", "in": "path", "description": "The identifier of the job.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "required": [ "mfa-response" ], "type": "object", "properties": { "mfa-response": { "type": "array", "description": "One time password or answer to a security question/s e.g. [\"1234\"]", "example": [ "1234" ], "items": { "type": "string" } } }, "x-readme-ref-name": "JobPostRequest" } } }, "required": true }, "responses": { "202": { "description": "Returns a job if MFA response was correct. Returns an error otherwise.", "content": { "application/json": { "schema": { "title": "ConnectionResponseResource", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"job\".", "example": "job" }, "id": { "type": "string", "description": "Job identification.", "example": "29523951" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing details for connection post.", "x-readme-ref-name": "ConnectionResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "401": { "description": "Error status response code indicates that the request has not been applied because it lacks valid authentication credentials for the target resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/accounts": { "get": { "tags": [ "Accounts" ], "summary": "List all accounts", "description": "List all accounts belonging to a user", "operationId": "getAccounts", "parameters": [ { "name": "userId", "in": "path", "description": "User identifier", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Account filters: account.id, connection.id, institution.id. Only the equals (eq) operation is currently supported.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a account with details.", "content": { "application/json": { "schema": { "required": [ "data", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"list\".", "example": "list" }, "data": { "type": "array", "description": "Container object, containing account details.", "items": { "title": "AccountResponseResource", "required": [ "type", "id", "lastUpdated", "status", "name", "displayName", "accountNo", "accountHolder", "isOwned", "accountOwnership", "balance", "availableFunds", "creditLimit", "currency", "class", "connection", "institution", "transactionIntervals" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Uniquely identifies the account.", "example": "s55bf3" }, "name": { "type": "string", "description": "Mapped directly from CDR 'nickname'. Represents the user-defined name for the account without fallback to displayName.", "example": "My Home Loan" }, "displayName": { "type": "string", "description": "Mapped directly from CDR 'displayName'. Represents the institution-defined display name for the account.", "example": "Hooli Home Loan" }, "depositRate": { "type": "string", "description": "current rate to calculate interest earned being applied to deposit balances as it stands at the time of the API call." }, "lendingRate": { "type": "string", "description": "The current rate to calculate interest payable being applied to lending balances as it stands at the time of the API call." }, "bsb": { "type": "string", "description": "The unmasked BSB for the account. Is expected to be formatted as digits only with leading zeros included and no punctuation or spaces." }, "unmaskedAccNum": { "type": "string", "description": "The unmasked account number for the account. Should not be supplied if the account number is a PAN requiring PCI compliance. Is expected to be formatted as digits only with leading zeros included and no punctuation or spaces." }, "creationDate": { "type": "string", "description": "Date that the account was created (if known)." }, "accountHolder": { "type": "string", "description": "The name of the account holder as returned by the institution. No formatting is applied. Returns a string or null when not available.", "nullable": true, "example": "GAVIN BELSON" }, "maskedNumber": { "type": "string", "description": "A masked version of the account. Whether BSB/Account Number, Credit Card PAN or another number." }, "accountOwnership": { "type": "string", "description": "Value indicating the number of customers that have ownership of the account, according to the data holder's definition of account ownership. Does not indicate that all account owners are eligible consumers.", "example": "ONE_PARTY", "enum": [ "UNKNOWN", "ONE_PARTY", "TWO_PARTY", "MANY_PARTY", "OTHER" ] }, "isOwned": { "type": "boolean", "description": "Flag indicating that the customer associated with the authorisation is an owner of the account. Does not indicate sole ownership, however. If not present then 'true' is assumed.", "example": true }, "amortisedLimit": { "type": "string", "description": "Object representing the available limit amortised according to payment schedule. Assumed to be zero if absent." }, "bundleName": { "type": "string", "description": "Optional field to indicate if this account is part of a bundle that is providing additional benefit to the customer." }, "purses": { "type": "array", "description": "Optional array of balances for the account in other currencies. Included to support accounts that support multi-currency purses such as Travel Cards.", "items": { "required": [ "amount" ], "properties": { "amount": { "type": "string", "description": "The balance available for this additional currency purse." }, "currency": { "type": "string", "description": "The currency for the purse." } }, "x-readme-ref-name": "pursesClass" } }, "accountNo": { "type": "string", "description": "BSB + account number.", "example": "600000157441965" }, "availableFunds": { "type": "string", "description": "Funds that are available to an account holder for withdrawal or other use. This may include funds from an overdraft facility or line of credit. As well as funds classified as the available balance, such as from cleared and existing deposits.", "nullable": true, "example": "420.28" }, "balance": { "type": "string", "description": "Amount of funds in the account right now - excluding any pending transactions. For a credit card this would be zero or the minus amount spent.", "nullable": true, "example": "356.50" }, "creditLimit": { "type": "string", "description": "Eligible account types are credit-card, loan and mortgage.", "nullable": true, "example": "400000.00" }, "class": { "type": "object", "description": "Describes the class (type) of accounts.", "required": [ "type", "product" ], "properties": { "type": { "type": "string", "description": "Account type", "example": "mortgage", "enum": [ "transaction", "savings", "credit-card", "mortgage", "loan", "investment", "term-deposit", "insurance", "foreign", "unknown" ] }, "product": { "type": "string", "description": "Product name.", "example": "Hooli Home Loan" } } }, "connection": { "type": "string", "description": "The id of the connection resource that was used to retrieve the account.", "example": "8fce3b" }, "currency": { "type": "string", "description": "The currency the funds are stored in, using ISO 4217 standard.", "example": "AUD" }, "institution": { "type": "string", "description": "The id of the institution resource the account originated from.", "example": "AU00000" }, "lastUpdated": { "type": "string", "description": "Timestamp of last update, UTC, RFC 3339 format e.g. \"2017-09-28T13:39:33Z\"", "example": "2019-09-28T13:39:33Z" }, "status": { "type": "string", "description": "Account status", "example": "available", "enum": [ "available", "unavailable" ] }, "meta": { "properties": { "fees": { "type": "array", "nullable": true, "items": { "required": [ "name", "feeType" ], "type": "object", "properties": { "name": { "type": "string", "description": "(mandatory) - Name of the fee.", "example": "Dishonour fee" }, "feeType": { "type": "string", "description": "(mandatory) - The type of fee.", "enum": [ "DEPOSIT", "EVENT", "EXIT", "PAYMENT", "PERIODIC", "PURCHASE", "TRANSACTION", "UPFRONT", "VARIABLE", "WITHDRAWAL" ], "example": "EVENT" }, "amount": { "type": "string", "description": "(conditional) - The amount charged for the fee.", "example": "10.00" }, "balanceRate": { "type": "string", "description": "A fee rate calculated based on a proportion of the balance. One of amount, balanceRate, transactionRate and accruedRate is mandatory unless the feeType \"VARIABLE\" is supplied." }, "transactionRate": { "type": "string", "description": "A fee rate calculated based on a proportion of a transaction. One of amount, balanceRate, transactionRate and accruedRate is mandatory unless the feeType \"VARIABLE\" is supplied." }, "accruedRate": { "type": "string", "description": "A fee rate calculated based on a proportion of the calculated interest accrued on the account. One of amount, balanceRate, transactionRate and accruedRate is mandatory unless the feeType \"VARIABLE\" is supplied." }, "accrualFrequency": { "type": "string", "description": "(optional) - The indicative frequency with which the fee is calculated on the account.", "example": "P1M" }, "currency": { "type": "string", "description": "The currency the fee will be charged in. Assumes AUD if absent." }, "additionalValue": { "type": "string", "description": "Display text providing more information on the fee." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the fee." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this fee." }, "discounts": { "type": "array", "nullable": true, "items": { "required": [ "discountType", "description" ], "properties": { "description": { "type": "string", "description": "Description of the discount." }, "discountType": { "type": "string", "description": "The type of discount. See the next section for an overview of valid values and their meaning." }, "amount": { "type": "string", "description": "Dollar value of the discount. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory." }, "balanceRate": { "type": "string", "description": "A discount rate calculated based on a proportion of the balance. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory. Unless noted in additionalInfo, assumes the application and calculation frequency are the same as the corresponding fee." }, "transactionRate": { "type": "string", "description": "A discount rate calculated based on a proportion of a transaction. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory." }, "accruedRate": { "type": "string", "description": "A discount rate calculated based on a proportion of the calculated interest accrued on the account. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory. Unless noted in additionalInfo, assumes the application and calculation frequency are the same as the corresponding fee." }, "feeRate": { "type": "string", "description": "A discount rate calculated based on a proportion of the fee to which this discount is attached. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory. Unless noted in additionalInfo, assumes the application and calculation frequency are the same as the corresponding fee." }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the discountType specified. Whether mandatory or not is dependent on the value of discountType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the discount." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this discount." }, "eligibility": { "description": "Eligibility constraints that apply to this discount. Mandatory if discountType is ELIGIBILITY_ONLY.", "required": [ "discountEligibilityType" ], "properties": { "discountEligibilityType": { "type": "string", "description": "The type of the specific eligibility constraint for a discountType.", "enum": [ "BUSINESS", "EMPLOYMENT_STATUS", "INTRODUCTORY", "MAX_AGE", "MIN_AGE", "MIN_INCOME", "MIN_TURNOVER", "NATURAL_PERSON", "OTHER", "PENSION_RECIPIENT", "RESIDENCY_STATUS", "STAFF", "STUDENT" ] }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the discountEligibilityType specified. Whether mandatory or not is dependent on the value of discountEligibilityType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on this eligibility constraint. Whether mandatory or not is dependent on the value of discountEligibilityType." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this eligibility constraint." } }, "x-readme-ref-name": "feesdiscounteligibilityMetadata" } }, "x-readme-ref-name": "feesdiscountMetadata" } } }, "x-readme-ref-name": "feesAccountMetadata" } }, "depositRates": { "type": "array", "nullable": true, "items": { "required": [ "depositRateType", "rate" ], "type": "object", "properties": { "depositRateType": { "type": "string", "description": "The type of rate (base, bonus, etc).", "example": "VARIABLE", "enum": [ "BONUS", "BUNDLE_BONUS", "FIXED", "FLOATING", "INTRODUCTORY", "MARKET_LINKED", "VARIABLE" ] }, "rate": { "type": "string", "description": "The rate to be applied.", "example": "0.0385" }, "calculationFrequency": { "type": "string", "description": "The period after which the rate is applied to the balance to calculate the amount due for the period. Calculation of the amount is often daily (as balances may change) but accumulated until the total amount is 'applied' to the account (see applicationFrequency). Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "applicationFrequency": { "type": "string", "description": "The period after which the calculated amount(s) are 'applied' (i.e. debited or credited) to the account.", "example": "P1M" }, "tiers": { "type": "array", "nullable": true, "items": { "required": [ "name", "unitOfMeasure", "minimumValue" ], "properties": { "name": { "type": "string", "description": "A display name for the tier." }, "unitOfMeasure": { "type": "string", "description": "The unit of measure that applies to the minimumValue and maximumValue values e.g. a DOLLAR amount. PERCENT (in the case of loan-to-value ratio or LVR). Tier term period representing a discrete number of MONTH's or DAY's (in the case of term deposit tiers).", "enum": [ "DAY", "DOLLAR", "MONTH", "PERCENT" ] }, "minimumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the lower bound of the tier. The tier should be inclusive of this value." }, "maximumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the upper bound of the tier or band. For a tier with a discrete value (as opposed to a range of values e.g. 1 month) this must be the same as minimumValue. Where this is the same as the minimumValue value of the next-higher tier the referenced tier should be exclusive of this value. For example a term deposit of 2 months falls into the upper tier of the following tiers: (1 - 2 months, 2 - 3 months). If absent the tier's range has no upper bound.. " }, "rateApplicationMethod": { "type": "string", "description": "The method used to calculate the amount to be applied using one or more tiers. A single rate may be applied to the entire balance or each applicable tier rate is applied to the portion of the balance that falls into that tier (referred to as 'bands' or 'steps').", "enum": [ "PER_TIER", "WHOLE_BALANCE" ] }, "applicabilityConditions": { "properties": { "additionalInfo": { "type": "string", "description": "Display text providing more information on the condition." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this condition." } }, "x-readme-ref-name": "feesAccountMetadepositratestiersRateCondition" }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate tier." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate tier." } }, "x-readme-ref-name": "feesAccountMetadepositratestiers" } }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the lendingRateType specified. Whether mandatory or not is dependent on the value of lendingRateType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate." } }, "x-readme-ref-name": "depositRateAccountMetadata" } }, "lendingRates": { "type": "array", "nullable": true, "items": { "required": [ "lendingRateType", "rate" ], "type": "object", "properties": { "lendingRateType": { "type": "string", "description": "The type of rate (fixed, variable, etc).", "example": "PURCHASE", "enum": [ "BUNDLE_DISCOUNT_FIXED", "BUNDLE_DISCOUNT_VARIABLE", "CASH_ADVANCE", "DISCOUNT", "FIXED", "FLOATING", "INTRODUCTORY", "MARKET_LINKED", "PENALTY", "PURCHASE", "VARIABLE" ] }, "rate": { "type": "string", "description": "The rate to be applied.", "example": "0.2024" }, "comparisonRate": { "type": "string", "description": "A comparison rate equivalent for this rate." }, "calculationFrequency": { "type": "string", "description": "The period after which the rate is applied to the balance to calculate the amount due for the period. Calculation of the amount is often daily (as balances may change) but accumulated until the total amount is 'applied' to the account (see applicationFrequency). Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "applicationFrequency": { "type": "string", "description": "The period after which the calculated amount(s) (see calculationFrequency) are 'applied' (i.e. debited or credited) to the account. Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "interestPaymentDue": { "type": "string", "description": "When loan payments are due to be paid within each period. The investment benefit of earlier payments affect the rate that can be offered.", "enum": [ "IN_ADVANCE", "IN_ARREARS" ], "example": "IN_ADVANCE" }, "repaymentType": { "type": "string", "description": "Options in place for repayments. If absent, the lending rate is applicable to all repayment types.", "enum": [ "INTEREST_ONLY", "PRINCIPAL_AND_INTEREST" ], "example": "INTEREST_ONLY" }, "loanPurpose": { "type": "string", "description": "The reason for taking out the loan. If absent, the lending rate is applicable to all loan purposes.", "enum": [ "INVESTMENT", "OWNER_OCCUPIED" ], "example": "INVESTMENT" }, "tiers": { "type": "array", "nullable": true, "items": { "required": [ "name", "unitOfMeasure", "minimumValue" ], "properties": { "name": { "type": "string", "description": "A display name for the tier." }, "unitOfMeasure": { "type": "string", "description": "The unit of measure that applies to the minimumValue and maximumValue values e.g. a DOLLAR amount. PERCENT (in the case of loan-to-value ratio or LVR). Tier term period representing a discrete number of MONTH's or DAY's (in the case of term deposit tiers).", "enum": [ "DAY", "DOLLAR", "MONTH", "PERCENT" ] }, "minimumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the lower bound of the tier. The tier should be inclusive of this value." }, "maximumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the upper bound of the tier or band. For a tier with a discrete value (as opposed to a range of values e.g. 1 month) this must be the same as minimumValue. Where this is the same as the minimumValue value of the next-higher tier the referenced tier should be exclusive of this value. For example a term deposit of 2 months falls into the upper tier of the following tiers: (1 - 2 months, 2 - 3 months). If absent the tier's range has no upper bound.. " }, "rateApplicationMethod": { "type": "string", "description": "The method used to calculate the amount to be applied using one or more tiers. A single rate may be applied to the entire balance or each applicable tier rate is applied to the portion of the balance that falls into that tier (referred to as 'bands' or 'steps').", "enum": [ "PER_TIER", "WHOLE_BALANCE" ] }, "applicabilityConditions": { "properties": { "additionalInfo": { "type": "string", "description": "Display text providing more information on the condition." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this condition." } }, "x-readme-ref-name": "feesAccountMetadepositratestiersRateCondition" }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate tier." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate tier." } }, "x-readme-ref-name": "feesAccountMetadepositratestiers" } }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the depositRateType specified. Whether mandatory or not is dependent on the value of depositRateType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate." } }, "x-readme-ref-name": "lendingRateAccountMetadata" } }, "termDeposit": { "type": "array", "items": { "required": [ "lodgementDate", "maturityDate", "maturityInstructions" ], "properties": { "lodgementDate": { "type": "string", "description": "The lodgement date of the original deposit." }, "maturityDate": { "type": "string", "description": "Maturity date for the term deposit." }, "maturityAmount": { "type": "string", "description": "Amount to be paid upon maturity. If absent, it implies the amount to paid is variable and cannot currently be calculated." }, "maturityCurrency": { "type": "string", "description": "If absent assumes AUD." }, "maturityInstructions": { "type": "string", "description": "Current instructions on action to be taken at maturity. This includes default actions that may be specified in the terms and conditions for the product e.g. roll-over to the same term and frequency of interest payments.", "enum": [ "HOLD_ON_MATURITY", "PAID_OUT_AT_MATURITY", "ROLLED_OVER" ], "example": "PAID_OUT_AT_MATURITY" } }, "x-readme-ref-name": "termDepositMetadata" } }, "loan": { "type": "object", "nullable": true, "properties": { "startDate": { "type": "string", "description": "Start date for the loan.", "example": "2019-10-01" }, "endDate": { "type": "string", "description": "Date that the loan is due to be repaid in full.", "example": "2045-10-01" }, "repaymentType": { "type": "string", "description": "Options in place for repayments. If absent defaults to PRINCIPAL_AND_INTEREST.", "example": "PRINCIPAL_AND_INTEREST", "enum": [ "INTEREST_ONLY", "PRINCIPAL_AND_INTEREST" ] }, "originalLoanAmount": { "type": "string", "description": "Optional loan value." }, "originalLoanCurrency": { "type": "string", "description": "If absent assumes AUD." }, "minInstalmentAmount": { "type": "string", "description": "Minimum amount of next instalment." }, "nextInstalmentDate": { "type": "string", "description": "Next date that an instalment is required." }, "minInstalmentCurrency": { "type": "string", "description": "If absent assumes AUD." }, "maxRedraw": { "type": "string", "description": "Maximum amount of funds that can be redrawn. If not present, redraw is not available even if the feature exists for the account." }, "maxRedrawCurrency": { "type": "string", "description": "If absent assumes AUD." }, "minRedraw": { "type": "string", "description": "Minimum redraw amount." }, "minRedrawCurrency": { "type": "string", "description": "If absent assumes AUD." }, "repaymentFrequency": { "type": "string", "description": "The expected or required repayment frequency. Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "offsetAccountIds": { "type": "array", "description": "The accountIDs of the configured offset accounts attached to this loan. Only offset accounts that can be accessed under the current authorisation should be included. It is expected behaviour that offsetAccountEnabled is set to true but the offsetAccountIds field is absent or empty. This represents a situation where an offset account exists but details can not be accessed under the current authorisation.", "items": { "type": "string" } }, "offsetAccountEnabled": { "type": "boolean", "description": "Set to true if one or more offset accounts are configured for this loan account.", "example": true } } }, "creditCard": { "required": [ "minPaymentAmount", "paymentDueAmount", "paymentDueDate" ], "type": "object", "properties": { "minPaymentAmount": { "type": "string", "description": "The minimum payment amount due for the next card payment.", "example": "117.00" }, "paymentDueAmount": { "type": "string", "description": "The amount due for the next card payment.", "example": "5847.00" }, "paymentCurrency": { "type": "string", "description": "If absent assumes AUD.", "example": "AUD" }, "paymentDueDate": { "type": "string", "description": "Date that the next payment for the card is due.", "example": "2023-12-12" } } }, "features": { "type": "array", "description": "Array of features available for the product.", "nullable": true, "items": { "required": [ "featureType" ], "properties": { "featureType": { "type": "string", "enum": [ "ADDITIONAL_CARDS", "BALANCE_TRANSFERS", "BILL_PAYMENT", "BONUS_REWARDS", "CARD_ACCESS", "CASHBACK_OFFER", "COMPLEMENTARY_PRODUCT_DISCOUNTS", "DIGITAL_BANKING", "DIGITAL_WALLET", "DONATE_INTEREST", "EXTRA_REPAYMENTS", "FRAUD_PROTECTION", "FREE_TXNS", "FREE_TXNS_ALLOWANCE", "GUARANTOR", "INSURANCE", "INSTALMENT_PLAN", "INTEREST_FREE", "INTEREST_FREE_TRANSFERS", "LOYALTY_PROGRAM", "NOTIFICATIONS", "NPP_ENABLED", "NPP_PAYID", "OFFSET", "OTHER", "OVERDRAFT", "REDRAW", "RELATIONSHIP_MANAGEMENT", "UNLIMITED_TXNS" ], "description": "The type of feature described." }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the featureType specified. Whether mandatory or not is dependent on the value of the featureType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the feature. Mandatory if the feature type is set to OTHER." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this feature." }, "isActivated": { "type": "boolean", "description": "true if the feature is already activated and false if the feature is available for activation. Defaults to true if absent.\n> Note: this is an additional field appended to the feature object defined in the Product Reference payload.\n", "example": true } }, "x-readme-ref-name": "featureClass" } }, "addresses": { "type": "array", "description": "The addresses for the account to be used for correspondence.", "nullable": true, "items": { "type": "object", "properties": { "addressType": { "type": "string", "description": "The type of address object present.", "enum": [ "paf", "simple" ], "example": "paf" }, "simple": { "required": [ "addressLine1", "city", "state" ], "type": "object", "properties": { "mailingName": { "type": "string", "description": "Name of the individual or business formatted for inclusion in an address used for physical mail." }, "addressLine1": { "type": "string", "description": "First line of the standard address object." }, "addressLine2": { "type": "string", "description": "Second line of the standard address object." }, "addressLine3": { "type": "string", "description": "Third line of the standard address object." }, "postcode": { "type": "string", "description": "Mandatory for Australian addresses." }, "city": { "type": "string", "description": "Name of the city or locality." }, "state": { "type": "string", "description": "Free text if the country is not Australia. If country is Australia then must be one of the values defined by the State Type Abbreviation in the PAF file format. NSW, QLD, VIC, NT, WA, SA, TAS, ACT." }, "country": { "type": "string", "description": "A valid ISO 3166 Alpha-3 country code. Australia (AUS) is assumed if country is not present." }, "paf": { "required": [ "localityName", "postcode", "state" ], "type": "object", "description": "Australian address formatted according to the file format defined by the PAF file format.", "properties": { "dpid": { "type": "string", "description": "Unique identifier for an address as defined by Australia Post. Also known as Delivery Point Identifier." }, "thoroughfareNumber1": { "type": "integer", "description": "Thoroughfare number for a property (first number in a property ranged address)." }, "thoroughfareNumber1Suffix": { "type": "string", "description": "Suffix for the thoroughfare number. Only relevant is thoroughfareNumber1 is populated." }, "thoroughfareNumber2": { "type": "integer", "description": "Second thoroughfare number (only used if the property has a ranged address eg 23-25)." }, "thoroughfareNumber2Suffix": { "type": "string", "description": "Suffix for the second thoroughfare number. Only relevant is thoroughfareNumber2 is populated." }, "flatUnitType": { "type": "string", "description": "Type of flat or unit for the address." }, "flatUnitNumber": { "type": "string", "description": "Unit number (including suffix, if applicable)." }, "floorLevelType": { "type": "string", "description": "Type of floor or level for the address." }, "floorLevelNumber": { "type": "string", "description": "Floor or level number (including alpha characters)." }, "lotNumber": { "type": "string", "description": "Allotment number for the address." }, "buildingName1": { "type": "string", "description": "Building/Property name 1." }, "buildingName2": { "type": "string", "description": "Building/Property name 2." }, "streetName": { "type": "string", "description": "The name of the street." }, "streetType": { "type": "string", "description": "The street type. Valid enumeration defined by Australia Post PAF code file." }, "streetSuffix": { "type": "string", "description": "The street type suffix. Valid enumeration defined by Australia Post PAF code file." }, "postalDeliveryType": { "type": "string", "description": "Postal delivery type. (eg. PO BOX). Valid enumeration defined by Australia Post PAF code file." }, "postalDeliveryNumber": { "type": "integer", "description": "Postal delivery number if the address is a postal delivery type." }, "postalDeliveryNumberPrefix": { "type": "string", "description": "Postal delivery number prefix related to the postal delivery number." }, "postalDeliveryNumberSuffix": { "type": "string", "description": "Postal delivery number suffix related to the postal delivery number." }, "localityName": { "type": "string", "description": "Full name of locality." }, "postcode": { "type": "string", "description": "Postcode for the locality." }, "state": { "type": "string", "description": "State in which the address belongs. Valid enumeration defined by Australia Post PAF code file State Type Abbreviation. NSW, QLD, VIC, NT, WA, SA, TAS, ACT, AAT." } } } } } } } } }, "x-readme-ref-name": "Metadata" }, "transactionIntervals": { "type": "array", "description": "An array of date intervals indicating the coverage of the transaction data relating to the account.\nWill return a single element for accounts sourced from a single bank connection.\nWill return multiple elements in cases where there have been multiple PDF/CSV uploads for an account.", "items": { "required": [ "from", "to" ], "type": "object", "properties": { "from": { "type": "string", "description": "Date of first transaction on this account", "example": "2018-07-01" }, "to": { "type": "string", "description": "Date of last transaction on this account", "example": "2018-12-30" } }, "x-readme-ref-name": "AccountTransactionInterval" } } }, "description": "Container object with account details", "x-readme-ref-name": "AccountResponseResource" } }, "links": { "title": "ResourceAccountLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/users/cd6fbd92/accounts/319ae910" }, "transactions": { "type": "string", "description": "transactions link to the transactions associated with this account.", "example": "https://au-api.basiq.io/users/ea3a81/transactions?filter=account.id.eq('s55bf3')" }, "connection": { "type": "string", "description": "connection associated to User.", "example": "https://au-api.basiq.io/users/cd6fbd92/connections/321312asa" }, "institution": { "type": "string", "description": "institution link to the institution associated with this account.", "example": "https://au-api.basiq.io/institutions/AU00000" }, "statements": { "type": "string", "example": [] } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceAccountLink" } }, "x-readme-ref-name": "AccountsResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" }, "examples": { "Bad Request": { "value": { "type": "list", "correlationId": "ac5ah5i", "data": [ { "type": "error", "title": "Parameter not valid.", "code": "parameter-not-valid", "detail": "ID value is not valid.", "source": { "parameter": "id" } } ] } }, "Invalid Filters": { "value": { "type": "list", "correlationId": "ac5ah55", "data": [ { "type": "error", "code": "parameter-not-valid", "title": "Parameter value is not valid", "detail": "The provided filter parameter is in invalid format or unsupported", "source": { "parameter": "filter" } } ] } } } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/accounts/{accountId}": { "get": { "tags": [ "Accounts" ], "summary": "Retrieve an account", "description": "Retrieve a specific account belonging to a user", "operationId": "getAccount", "parameters": [ { "name": "userId", "in": "path", "description": "User identifier", "required": true, "schema": { "type": "string" } }, { "name": "accountId", "in": "path", "description": "Account identifier", "required": true, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "description": "Account filters; account.id, connection.id, institution.id, Only equals (eq) operation is currently supported.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a account with details.", "content": { "application/json": { "schema": { "title": "AccountResponseResource", "required": [ "type", "id", "displayName", "lastUpdated", "status", "name", "accountNo", "accountHolder", "isOwned", "accountOwnership", "balance", "availableFunds", "creditLimit", "currency", "class", "connection", "institution", "transactionIntervals" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Uniquely identifies the account.", "example": "s55bf3" }, "name": { "type": "string", "description": "Mapped directly from CDR 'nickname'. Represents the user-defined name for the account without fallback to displayName.", "example": "My Home Loan" }, "displayName": { "type": "string", "description": "Mapped directly from CDR 'displayName'. Represents the institution-defined display name for the account.", "example": "Hooli Home Loan" }, "depositRate": { "type": "string", "description": "current rate to calculate interest earned being applied to deposit balances as it stands at the time of the API call." }, "lendingRate": { "type": "string", "description": "The current rate to calculate interest payable being applied to lending balances as it stands at the time of the API call." }, "bsb": { "type": "string", "description": "The unmasked BSB for the account. Is expected to be formatted as digits only with leading zeros included and no punctuation or spaces." }, "unmaskedAccNum": { "type": "string", "description": "The unmasked account number for the account. Should not be supplied if the account number is a PAN requiring PCI compliance. Is expected to be formatted as digits only with leading zeros included and no punctuation or spaces." }, "creationDate": { "type": "string", "description": "Date that the account was created (if known)." }, "accountHolder": { "type": "string", "description": "The name of the account holder as returned by the institution. No formatting is applied. Returns a string or null when not available.", "nullable": true, "example": "GAVIN BELSON" }, "maskedNumber": { "type": "string", "description": "A masked version of the account. Whether BSB/Account Number, Credit Card PAN or another number." }, "accountOwnership": { "type": "string", "description": "Value indicating the number of customers that have ownership of the account, according to the data holder's definition of account ownership. Does not indicate that all account owners are eligible consumers.", "example": "ONE_PARTY", "enum": [ "UNKNOWN", "ONE_PARTY", "TWO_PARTY", "MANY_PARTY", "OTHER" ] }, "isOwned": { "type": "boolean", "description": "Flag indicating that the customer associated with the authorisation is an owner of the account. Does not indicate sole ownership, however. If not present then 'true' is assumed.", "example": true }, "amortisedLimit": { "type": "string", "description": "Object representing the available limit amortised according to payment schedule. Assumed to be zero if absent." }, "bundleName": { "type": "string", "description": "Optional field to indicate if this account is part of a bundle that is providing additional benefit to the customer." }, "purses": { "type": "array", "description": "Optional array of balances for the account in other currencies. Included to support accounts that support multi-currency purses such as Travel Cards.", "items": { "required": [ "amount" ], "properties": { "amount": { "type": "string", "description": "The balance available for this additional currency purse." }, "currency": { "type": "string", "description": "The currency for the purse." } }, "x-readme-ref-name": "pursesClass" } }, "accountNo": { "type": "string", "description": "BSB + account number.", "example": "600000157441965" }, "availableFunds": { "type": "string", "description": "Funds that are available to an account holder for withdrawal or other use. This may include funds from an overdraft facility or line of credit. As well as funds classified as the available balance, such as from cleared and existing deposits.", "nullable": true, "example": "420.28" }, "balance": { "type": "string", "description": "Amount of funds in the account right now - excluding any pending transactions. For a credit card this would be zero or the minus amount spent.", "nullable": true, "example": "356.50" }, "creditLimit": { "type": "string", "description": "Eligible account types are credit-card, loan and mortgage.", "nullable": true, "example": "400000.00" }, "class": { "description": "Describes the class(type) of accounts. - transaction - savings - credit-card - mortgage - loan - investment - term-deposit - insurance - foreign - unknown", "required": [ "type", "product" ], "properties": { "type": { "type": "string", "description": "Account type", "example": "mortgage" }, "product": { "type": "string", "description": "Product name.", "example": "Hooli Home Loan" } }, "x-readme-ref-name": "AccountClass" }, "connection": { "type": "string", "description": "The id of the connection resource that was used to retrieve the account.", "example": "8fce3b" }, "currency": { "type": "string", "description": "The currency the funds are stored in, using ISO 4217 standard.", "example": "AUD" }, "institution": { "type": "string", "description": "The id of the institution resource the account originated from.", "example": "AU00000" }, "lastUpdated": { "type": "string", "description": "Timestamp of last update, UTC, RFC 3339 format e.g. \"2017-09-28T13:39:33Z\"", "example": "2019-09-28T13:39:33Z" }, "status": { "type": "string", "description": "Account status", "example": "available", "enum": [ "available", "unavailable" ] }, "meta": { "properties": { "fees": { "type": "array", "nullable": true, "items": { "required": [ "name", "feeType" ], "type": "object", "properties": { "name": { "type": "string", "description": "(mandatory) - Name of the fee.", "example": "Dishonour fee" }, "feeType": { "type": "string", "description": "(mandatory) - The type of fee.", "enum": [ "DEPOSIT", "EVENT", "EXIT", "PAYMENT", "PERIODIC", "PURCHASE", "TRANSACTION", "UPFRONT", "VARIABLE", "WITHDRAWAL" ], "example": "EVENT" }, "amount": { "type": "string", "description": "(conditional) - The amount charged for the fee.", "example": "10.00" }, "balanceRate": { "type": "string", "description": "A fee rate calculated based on a proportion of the balance. One of amount, balanceRate, transactionRate and accruedRate is mandatory unless the feeType \"VARIABLE\" is supplied." }, "transactionRate": { "type": "string", "description": "A fee rate calculated based on a proportion of a transaction. One of amount, balanceRate, transactionRate and accruedRate is mandatory unless the feeType \"VARIABLE\" is supplied." }, "accruedRate": { "type": "string", "description": "A fee rate calculated based on a proportion of the calculated interest accrued on the account. One of amount, balanceRate, transactionRate and accruedRate is mandatory unless the feeType \"VARIABLE\" is supplied." }, "accrualFrequency": { "type": "string", "description": "(optional) - The indicative frequency with which the fee is calculated on the account.", "example": "P1M" }, "currency": { "type": "string", "description": "The currency the fee will be charged in. Assumes AUD if absent." }, "additionalValue": { "type": "string", "description": "Display text providing more information on the fee." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the fee." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this fee." }, "discounts": { "type": "array", "nullable": true, "items": { "required": [ "discountType", "description" ], "properties": { "description": { "type": "string", "description": "Description of the discount." }, "discountType": { "type": "string", "description": "The type of discount. See the next section for an overview of valid values and their meaning." }, "amount": { "type": "string", "description": "Dollar value of the discount. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory." }, "balanceRate": { "type": "string", "description": "A discount rate calculated based on a proportion of the balance. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory. Unless noted in additionalInfo, assumes the application and calculation frequency are the same as the corresponding fee." }, "transactionRate": { "type": "string", "description": "A discount rate calculated based on a proportion of a transaction. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory." }, "accruedRate": { "type": "string", "description": "A discount rate calculated based on a proportion of the calculated interest accrued on the account. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory. Unless noted in additionalInfo, assumes the application and calculation frequency are the same as the corresponding fee." }, "feeRate": { "type": "string", "description": "A discount rate calculated based on a proportion of the fee to which this discount is attached. Note that the currency of the fee discount is expected to be the same as the currency of the fee itself. One of amount, balanceRate, transactionRate, accruedRate and feeRate is mandatory. Unless noted in additionalInfo, assumes the application and calculation frequency are the same as the corresponding fee." }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the discountType specified. Whether mandatory or not is dependent on the value of discountType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the discount." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this discount." }, "eligibility": { "description": "Eligibility constraints that apply to this discount. Mandatory if discountType is ELIGIBILITY_ONLY.", "required": [ "discountEligibilityType" ], "properties": { "discountEligibilityType": { "type": "string", "description": "The type of the specific eligibility constraint for a discountType.", "enum": [ "BUSINESS", "EMPLOYMENT_STATUS", "INTRODUCTORY", "MAX_AGE", "MIN_AGE", "MIN_INCOME", "MIN_TURNOVER", "NATURAL_PERSON", "OTHER", "PENSION_RECIPIENT", "RESIDENCY_STATUS", "STAFF", "STUDENT" ] }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the discountEligibilityType specified. Whether mandatory or not is dependent on the value of discountEligibilityType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on this eligibility constraint. Whether mandatory or not is dependent on the value of discountEligibilityType." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this eligibility constraint." } }, "x-readme-ref-name": "feesdiscounteligibilityMetadata" } }, "x-readme-ref-name": "feesdiscountMetadata" } } }, "x-readme-ref-name": "feesAccountMetadata" } }, "depositRates": { "type": "array", "nullable": true, "items": { "required": [ "depositRateType", "rate" ], "type": "object", "properties": { "depositRateType": { "type": "string", "description": "The type of rate (base, bonus, etc).", "example": "VARIABLE", "enum": [ "BONUS", "BUNDLE_BONUS", "FIXED", "FLOATING", "INTRODUCTORY", "MARKET_LINKED", "VARIABLE" ] }, "rate": { "type": "string", "description": "The rate to be applied.", "example": "0.0385" }, "calculationFrequency": { "type": "string", "description": "The period after which the rate is applied to the balance to calculate the amount due for the period. Calculation of the amount is often daily (as balances may change) but accumulated until the total amount is 'applied' to the account (see applicationFrequency). Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "applicationFrequency": { "type": "string", "description": "The period after which the calculated amount(s) are 'applied' (i.e. debited or credited) to the account.", "example": "P1M" }, "tiers": { "type": "array", "nullable": true, "items": { "required": [ "name", "unitOfMeasure", "minimumValue" ], "properties": { "name": { "type": "string", "description": "A display name for the tier." }, "unitOfMeasure": { "type": "string", "description": "The unit of measure that applies to the minimumValue and maximumValue values e.g. a DOLLAR amount. PERCENT (in the case of loan-to-value ratio or LVR). Tier term period representing a discrete number of MONTH's or DAY's (in the case of term deposit tiers).", "enum": [ "DAY", "DOLLAR", "MONTH", "PERCENT" ] }, "minimumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the lower bound of the tier. The tier should be inclusive of this value." }, "maximumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the upper bound of the tier or band. For a tier with a discrete value (as opposed to a range of values e.g. 1 month) this must be the same as minimumValue. Where this is the same as the minimumValue value of the next-higher tier the referenced tier should be exclusive of this value. For example a term deposit of 2 months falls into the upper tier of the following tiers: (1 - 2 months, 2 - 3 months). If absent the tier's range has no upper bound.. " }, "rateApplicationMethod": { "type": "string", "description": "The method used to calculate the amount to be applied using one or more tiers. A single rate may be applied to the entire balance or each applicable tier rate is applied to the portion of the balance that falls into that tier (referred to as 'bands' or 'steps').", "enum": [ "PER_TIER", "WHOLE_BALANCE" ] }, "applicabilityConditions": { "properties": { "additionalInfo": { "type": "string", "description": "Display text providing more information on the condition." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this condition." } }, "x-readme-ref-name": "feesAccountMetadepositratestiersRateCondition" }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate tier." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate tier." } }, "x-readme-ref-name": "feesAccountMetadepositratestiers" } }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the lendingRateType specified. Whether mandatory or not is dependent on the value of lendingRateType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate." } }, "x-readme-ref-name": "depositRateAccountMetadata" } }, "lendingRates": { "type": "array", "nullable": true, "items": { "required": [ "lendingRateType", "rate" ], "type": "object", "properties": { "lendingRateType": { "type": "string", "description": "The type of rate (fixed, variable, etc).", "example": "PURCHASE", "enum": [ "BUNDLE_DISCOUNT_FIXED", "BUNDLE_DISCOUNT_VARIABLE", "CASH_ADVANCE", "DISCOUNT", "FIXED", "FLOATING", "INTRODUCTORY", "MARKET_LINKED", "PENALTY", "PURCHASE", "VARIABLE" ] }, "rate": { "type": "string", "description": "The rate to be applied.", "example": "0.2024" }, "comparisonRate": { "type": "string", "description": "A comparison rate equivalent for this rate." }, "calculationFrequency": { "type": "string", "description": "The period after which the rate is applied to the balance to calculate the amount due for the period. Calculation of the amount is often daily (as balances may change) but accumulated until the total amount is 'applied' to the account (see applicationFrequency). Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "applicationFrequency": { "type": "string", "description": "The period after which the calculated amount(s) (see calculationFrequency) are 'applied' (i.e. debited or credited) to the account. Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "interestPaymentDue": { "type": "string", "description": "When loan payments are due to be paid within each period. The investment benefit of earlier payments affect the rate that can be offered.", "enum": [ "IN_ADVANCE", "IN_ARREARS" ], "example": "IN_ADVANCE" }, "repaymentType": { "type": "string", "description": "Options in place for repayments. If absent, the lending rate is applicable to all repayment types.", "enum": [ "INTEREST_ONLY", "PRINCIPAL_AND_INTEREST" ], "example": "INTEREST_ONLY" }, "loanPurpose": { "type": "string", "description": "The reason for taking out the loan. If absent, the lending rate is applicable to all loan purposes.", "enum": [ "INVESTMENT", "OWNER_OCCUPIED" ], "example": "INVESTMENT" }, "tiers": { "type": "array", "nullable": true, "items": { "required": [ "name", "unitOfMeasure", "minimumValue" ], "properties": { "name": { "type": "string", "description": "A display name for the tier." }, "unitOfMeasure": { "type": "string", "description": "The unit of measure that applies to the minimumValue and maximumValue values e.g. a DOLLAR amount. PERCENT (in the case of loan-to-value ratio or LVR). Tier term period representing a discrete number of MONTH's or DAY's (in the case of term deposit tiers).", "enum": [ "DAY", "DOLLAR", "MONTH", "PERCENT" ] }, "minimumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the lower bound of the tier. The tier should be inclusive of this value." }, "maximumValue": { "type": "integer", "description": "The number of unitOfMeasure units that form the upper bound of the tier or band. For a tier with a discrete value (as opposed to a range of values e.g. 1 month) this must be the same as minimumValue. Where this is the same as the minimumValue value of the next-higher tier the referenced tier should be exclusive of this value. For example a term deposit of 2 months falls into the upper tier of the following tiers: (1 - 2 months, 2 - 3 months). If absent the tier's range has no upper bound.. " }, "rateApplicationMethod": { "type": "string", "description": "The method used to calculate the amount to be applied using one or more tiers. A single rate may be applied to the entire balance or each applicable tier rate is applied to the portion of the balance that falls into that tier (referred to as 'bands' or 'steps').", "enum": [ "PER_TIER", "WHOLE_BALANCE" ] }, "applicabilityConditions": { "properties": { "additionalInfo": { "type": "string", "description": "Display text providing more information on the condition." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this condition." } }, "x-readme-ref-name": "feesAccountMetadepositratestiersRateCondition" }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate tier." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate tier." } }, "x-readme-ref-name": "feesAccountMetadepositratestiers" } }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the depositRateType specified. Whether mandatory or not is dependent on the value of depositRateType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the rate." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this rate." } }, "x-readme-ref-name": "lendingRateAccountMetadata" } }, "termDeposit": { "type": "array", "items": { "required": [ "lodgementDate", "maturityDate", "maturityInstructions" ], "properties": { "lodgementDate": { "type": "string", "description": "The lodgement date of the original deposit." }, "maturityDate": { "type": "string", "description": "Maturity date for the term deposit." }, "maturityAmount": { "type": "string", "description": "Amount to be paid upon maturity. If absent, it implies the amount to paid is variable and cannot currently be calculated." }, "maturityCurrency": { "type": "string", "description": "If absent assumes AUD." }, "maturityInstructions": { "type": "string", "description": "Current instructions on action to be taken at maturity. This includes default actions that may be specified in the terms and conditions for the product e.g. roll-over to the same term and frequency of interest payments.", "enum": [ "HOLD_ON_MATURITY", "PAID_OUT_AT_MATURITY", "ROLLED_OVER" ], "example": "PAID_OUT_AT_MATURITY" } }, "x-readme-ref-name": "termDepositMetadata" } }, "loan": { "type": "object", "nullable": true, "properties": { "startDate": { "type": "string", "description": "Start date for the loan.", "example": "2019-10-01" }, "endDate": { "type": "string", "description": "Date that the loan is due to be repaid in full.", "example": "2045-10-01" }, "repaymentType": { "type": "string", "description": "Options in place for repayments. If absent defaults to PRINCIPAL_AND_INTEREST.", "example": "PRINCIPAL_AND_INTEREST", "enum": [ "INTEREST_ONLY", "PRINCIPAL_AND_INTEREST" ] }, "originalLoanAmount": { "type": "string", "description": "Optional loan value." }, "originalLoanCurrency": { "type": "string", "description": "If absent assumes AUD." }, "minInstalmentAmount": { "type": "string", "description": "Minimum amount of next instalment." }, "nextInstalmentDate": { "type": "string", "description": "Next date that an instalment is required." }, "minInstalmentCurrency": { "type": "string", "description": "If absent assumes AUD." }, "maxRedraw": { "type": "string", "description": "Maximum amount of funds that can be redrawn. If not present, redraw is not available even if the feature exists for the account." }, "maxRedrawCurrency": { "type": "string", "description": "If absent assumes AUD." }, "minRedraw": { "type": "string", "description": "Minimum redraw amount." }, "minRedrawCurrency": { "type": "string", "description": "If absent assumes AUD." }, "repaymentFrequency": { "type": "string", "description": "The expected or required repayment frequency. Formatted according to ISO 8601 Durations (excludes recurrence syntax)." }, "offsetAccountIds": { "type": "array", "description": "The accountIDs of the configured offset accounts attached to this loan. Only offset accounts that can be accessed under the current authorisation should be included. It is expected behaviour that offsetAccountEnabled is set to true but the offsetAccountIds field is absent or empty. This represents a situation where an offset account exists but details can not be accessed under the current authorisation.", "items": { "type": "string" } }, "offsetAccountEnabled": { "type": "boolean", "description": "Set to true if one or more offset accounts are configured for this loan account.", "example": true } } }, "creditCard": { "required": [ "minPaymentAmount", "paymentDueAmount", "paymentDueDate" ], "type": "object", "properties": { "minPaymentAmount": { "type": "string", "description": "The minimum payment amount due for the next card payment.", "example": "117.00" }, "paymentDueAmount": { "type": "string", "description": "The amount due for the next card payment.", "example": "5847.00" }, "paymentCurrency": { "type": "string", "description": "If absent assumes AUD.", "example": "AUD" }, "paymentDueDate": { "type": "string", "description": "Date that the next payment for the card is due.", "example": "2023-12-12" } } }, "features": { "type": "array", "description": "Array of features available for the product.", "nullable": true, "items": { "required": [ "featureType" ], "properties": { "featureType": { "type": "string", "enum": [ "ADDITIONAL_CARDS", "BALANCE_TRANSFERS", "BILL_PAYMENT", "BONUS_REWARDS", "CARD_ACCESS", "CASHBACK_OFFER", "COMPLEMENTARY_PRODUCT_DISCOUNTS", "DIGITAL_BANKING", "DIGITAL_WALLET", "DONATE_INTEREST", "EXTRA_REPAYMENTS", "FRAUD_PROTECTION", "FREE_TXNS", "FREE_TXNS_ALLOWANCE", "GUARANTOR", "INSURANCE", "INSTALMENT_PLAN", "INTEREST_FREE", "INTEREST_FREE_TRANSFERS", "LOYALTY_PROGRAM", "NOTIFICATIONS", "NPP_ENABLED", "NPP_PAYID", "OFFSET", "OTHER", "OVERDRAFT", "REDRAW", "RELATIONSHIP_MANAGEMENT", "UNLIMITED_TXNS" ], "description": "The type of feature described." }, "additionalValue": { "type": "string", "description": "Generic field containing additional information relevant to the featureType specified. Whether mandatory or not is dependent on the value of the featureType." }, "additionalInfo": { "type": "string", "description": "Display text providing more information on the feature. Mandatory if the feature type is set to OTHER." }, "additionalInfoUri": { "type": "string", "description": "Link to a web page with more information on this feature." }, "isActivated": { "type": "boolean", "description": "true if the feature is already activated and false if the feature is available for activation. Defaults to true if absent.\n> Note: this is an additional field appended to the feature object defined in the Product Reference payload.\n", "example": true } }, "x-readme-ref-name": "featureClass" } }, "addresses": { "type": "array", "description": "The addresses for the account to be used for correspondence.", "nullable": true, "items": { "type": "object", "properties": { "addressType": { "type": "string", "description": "The type of address object present.", "enum": [ "paf", "simple" ], "example": "paf" }, "simple": { "required": [ "addressLine1", "city", "state" ], "type": "object", "properties": { "mailingName": { "type": "string", "description": "Name of the individual or business formatted for inclusion in an address used for physical mail." }, "addressLine1": { "type": "string", "description": "First line of the standard address object." }, "addressLine2": { "type": "string", "description": "Second line of the standard address object." }, "addressLine3": { "type": "string", "description": "Third line of the standard address object." }, "postcode": { "type": "string", "description": "Mandatory for Australian addresses." }, "city": { "type": "string", "description": "Name of the city or locality." }, "state": { "type": "string", "description": "Free text if the country is not Australia. If country is Australia then must be one of the values defined by the State Type Abbreviation in the PAF file format. NSW, QLD, VIC, NT, WA, SA, TAS, ACT." }, "country": { "type": "string", "description": "A valid ISO 3166 Alpha-3 country code. Australia (AUS) is assumed if country is not present." }, "paf": { "required": [ "localityName", "postcode", "state" ], "type": "object", "description": "Australian address formatted according to the file format defined by the PAF file format.", "properties": { "dpid": { "type": "string", "description": "Unique identifier for an address as defined by Australia Post. Also known as Delivery Point Identifier." }, "thoroughfareNumber1": { "type": "integer", "description": "Thoroughfare number for a property (first number in a property ranged address)." }, "thoroughfareNumber1Suffix": { "type": "string", "description": "Suffix for the thoroughfare number. Only relevant is thoroughfareNumber1 is populated." }, "thoroughfareNumber2": { "type": "integer", "description": "Second thoroughfare number (only used if the property has a ranged address eg 23-25)." }, "thoroughfareNumber2Suffix": { "type": "string", "description": "Suffix for the second thoroughfare number. Only relevant is thoroughfareNumber2 is populated." }, "flatUnitType": { "type": "string", "description": "Type of flat or unit for the address." }, "flatUnitNumber": { "type": "string", "description": "Unit number (including suffix, if applicable)." }, "floorLevelType": { "type": "string", "description": "Type of floor or level for the address." }, "floorLevelNumber": { "type": "string", "description": "Floor or level number (including alpha characters)." }, "lotNumber": { "type": "string", "description": "Allotment number for the address." }, "buildingName1": { "type": "string", "description": "Building/Property name 1." }, "buildingName2": { "type": "string", "description": "Building/Property name 2." }, "streetName": { "type": "string", "description": "The name of the street." }, "streetType": { "type": "string", "description": "The street type. Valid enumeration defined by Australia Post PAF code file." }, "streetSuffix": { "type": "string", "description": "The street type suffix. Valid enumeration defined by Australia Post PAF code file." }, "postalDeliveryType": { "type": "string", "description": "Postal delivery type. (eg. PO BOX). Valid enumeration defined by Australia Post PAF code file." }, "postalDeliveryNumber": { "type": "integer", "description": "Postal delivery number if the address is a postal delivery type." }, "postalDeliveryNumberPrefix": { "type": "string", "description": "Postal delivery number prefix related to the postal delivery number." }, "postalDeliveryNumberSuffix": { "type": "string", "description": "Postal delivery number suffix related to the postal delivery number." }, "localityName": { "type": "string", "description": "Full name of locality." }, "postcode": { "type": "string", "description": "Postcode for the locality." }, "state": { "type": "string", "description": "State in which the address belongs. Valid enumeration defined by Australia Post PAF code file State Type Abbreviation. NSW, QLD, VIC, NT, WA, SA, TAS, ACT, AAT." } } } } } } } } }, "x-readme-ref-name": "Metadata" }, "transactionIntervals": { "type": "array", "description": "An array of date intervals indicating the coverage of the transaction data relating to the account.\nWill return a single element for accounts sourced from a single bank connection.\nWill return multiple elements in cases where there have been multiple PDF/CSV uploads for an account.", "items": { "required": [ "from", "to" ], "type": "object", "properties": { "from": { "type": "string", "description": "Date of first transaction on this account", "example": "2018-07-01" }, "to": { "type": "string", "description": "Date of last transaction on this account", "example": "2018-12-30" } }, "x-readme-ref-name": "AccountTransactionInterval" } } }, "description": "Container object with account details", "x-readme-ref-name": "AccountResponseResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/transactions": { "get": { "tags": [ "Transactions" ], "summary": "List all transactions", "description": "List all transactions belonging to a specified user", "operationId": "getTransactions", "parameters": [ { "name": "userId", "in": "path", "description": "User identifier.", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "This represents the maximum number of items that may be included in the response (maximum of 500). Note that by default 500 items are returned if this value is not specified.", "schema": { "type": "integer", "format": "int64", "default": 500 } }, { "name": "filter", "in": "query", "description": "Transaction filters; connection.id, account.id, transaction.postDate, transaction.status, institution.id, transaction.direction, transaction.class", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a paginated list with a data property that contains an array of transactions. Each entry in the array is a separate object. If no data is returned, the resulting array will be empty. ", "content": { "application/json": { "schema": { "title": "Transactions container object.", "required": [ "count", "data", "size", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Value is \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of the transactions in the response.", "format": "int64", "example": 100 }, "size": { "type": "integer", "format": "int64", "example": 500 }, "data": { "type": "array", "items": { "required": [ "id", "status", "description", "reference", "account", "amount", "currency", "class", "subClass", "connection", "direction", "enrich", "institution", "links", "postDate", "transactionDate", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Value is \"transaction\".", "example": "transaction" }, "id": { "type": "string", "description": "Uniquely identifies the transaction for this connection. Note that when a connection is refreshed pending transactions will receive new id's, whilst posted transactions will receive the same id's as before the refresh.", "example": "d3de1ca1" }, "status": { "type": "string", "description": "Identifies if a transaction is pending or posted. A pending transaction is an approved debit or credit transaction that has not been fully processed yet (i.e. has not been posted). Note that pending transactions are not available for all institutions.", "example": "posted", "enum": [ "pending", "posted" ] }, "description": { "type": "string", "description": "The transaction description as submitted by the institution." }, "reference": { "type": "string", "description": "The reference for the transaction provided by the originating institution." }, "amount": { "type": "string", "description": "Transaction amount. Outgoing funds are expressed as negative values.", "example": "123.12" }, "currency": { "type": "string", "description": "Standard 3 character currency codes as per ISO-4217.", "enum": [ "AUD", "USD", "GBP" ] }, "account": { "type": "string", "description": "The id of the account resource the transaction belongs to.", "example": "d3de1ca1" }, "balance": { "type": "string", "description": "Account balance at the time the transaction was completed. Included for Web connection integrations. CDR does not supply transaction balance, so this field will be empty for CDR connections.", "example": "123.12" }, "direction": { "type": "string", "description": "Identifies if the transaction is of debit or credit type.", "example": "debit", "enum": [ "debit", "credit" ] }, "class": { "type": "string", "description": "Describes the class(type) of transaction.", "example": "payment", "enum": [ "bank-fee", "payment", "cash-withdrawal", "transfer", "loan-interest", "refund", "direct-credit", "interest", "loan-repayment" ] }, "institution": { "type": "string", "description": "The id of the institution resource the transaction originated from.", "example": "AU00000" }, "connection": { "type": "string", "description": "The id of the connection resource that was used to retrieve the transaction.", "example": "d3de1ca1" }, "transactionDate": { "type": "string", "description": "Date that the user executed the transaction as provided by the institution. Note that not all transactions provide this value (varies by institution) e.g. \"2017-11-10T00:00:00Z\"", "example": null }, "paymentDetails": { "type": "object", "properties": { "bpay": { "type": "object", "properties": { "billerCode": { "type": "string", "description": "BPAY Biller Code for the transaction." }, "billerName": { "type": "string", "description": "Name of the BPAY biller for the transaction." }, "crn": { "type": "string", "description": "CRN for the transaction." } } }, "apcaNumber": { "type": "string", "description": "6 Digit APCA number for the initiating institution. The field is fixed-width and padded with leading zeros if applicable.\n" } } }, "postDate": { "type": "string", "description": "Date the transaction was posted as provided by the institution. This value is null if the record is pending. e.g. \"2017-11-10T21:46:44Z\" or 2017-11-10T00:00:00Z.", "example": "2018-11-02T00:00:00Z" }, "subClass": { "type": "object", "description": "The subClass attribute will only return values for payment transactions (i.e. will be empty for all others) plus [new] bank fee transactions for those relating to account conduct such as account overdrawn and direct debit dishonours.", "properties": { "code": { "type": "string", "description": "code", "example": 722 }, "title": { "type": "string", "description": "SubClass title", "example": "Cafes and Restaurants" } } }, "enrich": { "required": [ "cleanDescription", "tags", "category", "location", "merchant" ], "type": "object", "properties": { "location": { "type": "object", "nullable": true, "properties": { "country": { "type": "string", "description": "Country", "example": "Australia" }, "formattedAddress": { "type": "string", "description": "Address", "example": "1/39 E Esplanade, Manly NSW 2095" }, "geometry": { "type": "object", "properties": { "lat": { "type": "string", "description": "Latitude", "example": "-33.79988520000001" }, "lng": { "type": "string", "description": "Longitude", "example": "151.2858021" } }, "x-readme-ref-name": "TransactionsGeometry" }, "postalCode": { "type": "string", "description": "Postal Code", "example": "2095" }, "route": { "type": "string", "description": "Route Name", "example": "E Esplanade" }, "routeNo": { "type": "string", "description": "Route Number", "example": "29" }, "state": { "type": "string", "description": "State", "example": "NSW" }, "suburb": { "type": "string", "description": "Suburb", "example": "Manly" } }, "x-readme-ref-name": "TransactionsLocation" }, "cleanDescription": { "type": "string", "description": "", "x-readme-ref-name": "TransactionscleanDescription" }, "tags": { "type": "array", "items": { "type": "string", "description": "This array contains tags that are formatted as `tag_name:tag_value`. Each `tag_name` corresponds to a specific category of transaction information, and the `tag_value` provides a detailed classification within that category.\n- For example, the `card` tag_name will have a 4-digit number as tag_value (e.g., \"card:4615\").\n- The `conduct` tag_name can have values like `card`, `overdrawn`, `cheque`, `atm`, `currency`, `late`, `admin`, `dishonour`, `interest` (e.g., \"conduct:cheque\").\n- The `governmentPayment` tag_name might have values such as `centrelink`, `centrelinkCarers`, `crisisSupport`, `education`, `familyAllowance`, `jobseekerPymt`, `medicare`, `newstart`, `pension`, `rentalAssistance`, `vetAffairs`, `youthAllowance` (e.g., \"governmentPayment:centrelink\").\n- The `income` tag_name could include values like `childSupport`, `insurance`, `investment`, `rent`, `salary`, `superannuation` (e.g., \"income:salary\").\n- The `liability` tag_name could include values like `afterpay`, `arl collect pty ltd`, `australian recoveries`, `axess`, `azora`, `baycorp`, `beforepay`, `brighte`, `bundll`, `cash converters`, `cash direct`, `cashngo`, `cash stop`, `cash train`, `ccc`, `cfmg pty ltd`, `charter mercantile`, `cigno`, `collectau`, `collection house`, `complete credit solutions`, `credit collection services`, `credit corp`, `creditline`, `deferit`, `dun and bradstreet`, `earnd`, `edstart`, `finance one`, `fundo`, `fupay`, `gem visa`, `humm`, `indebted`, `klarna`, `latitude`, `laybuy`, `limepay`, `lion finance`, `money3`, `moneyloop`, `mypaynow`, `nimble`, `nine25`, `openpay`, `panthera`, `payitlater`, `payright`, `pioneer credit`, `plenti`, `probe`, `q card`, `quickapay`, `spotmenow`, `sunshine loans`, `tapmypay`, `wagetap`, `wallet wizard`, `zip pay` (e.g., \"liability:afterpay\").\n- The `third-party` tag_name might include values like `apple pay`, `google`, `paypal`, `sp`, `sq` (e.g., \"third-party:paypal\").\n- The `creditCard` tag_name is used with the value `creditCard` (e.g., \"creditCard:creditCard\").\n- The `expense` tag_name is used with the value `rent` (e.g., \"expense:rent\").\n- The `loan` tag_name is used with the value `loan repayment` (e.g., \"loan:loan repayment\").\n- The `mortgage` tag_name could include values like `afg home loans`, `aims`, `amo group`, `athena`, `aussie`, `bluestone`, `clickloans`, `emoney`, `express reverse mortgage`, `firstmac`, `fox symes`, `freedom lend`, `freedom loans`, `funding`, `heartland reverse mortgages`, `homeloans`, `homestar`, `homestart`, `household capital`, `illawarra home loans`, `keystart`, `la trobe financial`, `liberty financial`, `loans`, `mortgage house`, `mortgage offset`, `mortgageport`, `mortgage repayment`, `onetwo`, `online home loans`, `pacific mortgage group`, `pepper money`, `qantas money`, `reduce home loans`, `resi`, `resimac`, `sucasa`, `switzer home loans`, `ticToc`, `unloan`, `vmg`, `well money` (e.g., \"mortgage:afg home loans\").\n", "example": "conduct:dishonour" }, "description": "This field contains an array of strings, each representing a specific tag for the transaction. The format of each string should be `tag_name:tag_value`, where `tag_name` defines the type of transaction (e.g., `card`, `income`, `mortgage`), and `tag_value` provides additional details (e.g., \"card:4615\"). The tags help classify and identify transactions based on various criteria.\n\n - card:4615\n - conduct:card\n - conduct:overdrawn\n - conduct:cheque\n - conduct:atm\n - conduct:currency\n - conduct:late\n - conduct:admin\n - conduct:dishonour\n - conduct:interest\n - governmentPayment:centrelink\n - governmentPayment:centrelinkCarers\n - governmentPayment:crisisSupport\n - governmentPayment:education\n - governmentPayment:familyAllowance\n - governmentPayment:jobseekerPymt\n - governmentPayment:medicare\n - governmentPayment:newstart\n - governmentPayment:pension\n - governmentPayment:rentalAssistance\n - governmentPayment:vetAffairs\n - governmentPayment:youthAllowance\n - income:childSupport\n - income:insurance\n - income:investment\n - income:rent\n - income:salary\n - income:superannuation\n - liability:afterpay\n - liability:arl collect pty ltd\n - liability:australian recoveries\n - liability:axess\n - liability:azora\n - liability:baycorp\n - liability:beforepay\n - liability:brighte\n - liability:bundll\n - liability:cash converters\n - liability:cash direct\n - liability:cashngo\n - liability:cash stop\n - liability:cash train\n - liability:ccc\n - liability:cfmg pty ltd\n - liability:charter mercantile\n - liability:cigno\n - liability:collectau\n - liability:collection house\n - liability:complete credit solutions\n - liability:credit collection services\n - liability:credit corp\n - liability:creditline\n - liability:deferit\n - liability:dun and bradstreet\n - liability:earnd\n - liability:edstart\n - liability:finance one\n - liability:fundo\n - liability:fupay\n - liability:gem visa\n - liability:humm\n - liability:indebted\n - liability:klarna\n - liability:latitude\n - liability:laybuy\n - liability:limepay\n - liability:lion finance\n - liability:money3\n - liability:moneyloop\n - liability:mypaynow\n - liability:nimble\n - liability:nine25\n - liability:openpay\n - liability:panthera\n - liability:payitlater\n - liability:payright\n - liability:pioneer credit\n - liability:plenti\n - liability:probe\n - liability:q card\n - liability:quickapay\n - liability:spotmenow\n - liability:sunshine loans\n - liability:tapmypay\n - liability:wagetap\n - liability:wallet wizard\n - liability:zip pay\n - third-party:apple pay\n - third-party:google\n - third-party:paypal\n - third-party:sp\n - third-party:sq\n - creditCard:creditCard\n - expense:rent\n - loan:loan repayment\n - mortgage:afg home loans\n - mortgage:aims\n - mortgage:amo group\n - mortgage:athena\n - mortgage:aussie\n - mortgage:bluestone\n - mortgage:clickloans\n - mortgage:emoney\n - mortgage:express reverse mortgage\n - mortgage:firstmac\n - mortgage:fox symes\n - mortgage:freedom lend\n - mortgage:freedom loans\n - mortgage:funding\n - mortgage:heartland reverse mortgages\n - mortgage:homeloans\n - mortgage:homestar\n - mortgage:homestart\n - mortgage:household capital\n - mortgage:illawarra home loans\n - mortgage:keystart\n - mortgage:la trobe financial\n - mortgage:liberty financial\n - mortgage:loans\n - mortgage:mortgage house\n - mortgage:mortgage offset\n - mortgage:mortgageport\n - mortgage:mortgage repayment\n - mortgage:onetwo\n - mortgage:online home loans\n - mortgage:pacific mortgage group\n - mortgage:pepper money\n - mortgage:qantas money\n - mortgage:reduce home loans\n - mortgage:resi\n - mortgage:resimac\n - mortgage:sucasa\n - mortgage:switzer home loans\n - mortgage:ticToc\n - mortgage:unloan\n - mortgage:vmg\n - mortgage:well money\n", "x-readme-ref-name": "Transactionstags" }, "merchant": { "required": [ "id", "businessName", "ABN", "website", "logoMaster", "logoThumb" ], "type": "object", "nullable": true, "properties": { "id": { "type": "string", "description": "id", "example": "ae4a051c-4791-11e8-8750-0a87c0279fe8" }, "businessName": { "type": "string", "description": "Merchant name", "example": "Garfish Manly" }, "ABN": { "type": "string", "description": "ABN", "example": "90065628864" }, "logoMaster": { "type": "string", "description": "full merchant logo", "example": "https://enrich-enrichmerchantslogobucket-x62p53eh5ld9.s3-ap-southeast-2.amazonaws.com/officeworks-master.png" }, "logoThumb": { "type": "string", "description": "thumbnail merchant logo", "example": "https://enrich-enrichmerchantslogobucket-x62p53eh5ld9.s3-ap-southeast-2.amazonaws.com/officeworks-thumb.png" }, "phoneNumber": { "type": "object", "properties": { "international": { "type": "string", "description": "International Phone Number", "example": "+61 2 9977 0707" }, "local": { "type": "string", "description": "Local Phone Number", "example": "(02) 9977 0707" } }, "x-readme-ref-name": "TransactionsPhoneNumber" }, "website": { "type": "string", "description": "Merchant Website", "example": "http://garfish.com.au/garfish-manly/" } }, "x-readme-ref-name": "TransactionsMerchant" }, "category": { "type": "object", "nullable": true, "properties": { "matchType": { "type": "string", "description": "Indicates the method used to match a payment transaction with a merchant or business classification code. Description for each enum; merchantFull: Indicates an exact match between the transaction and a known merchant in the database. merchantPartial: Suggests a partial match with a merchant, usually based on substring or fuzzy logic. mcc: Match is done using the Merchant Category Code associated with the transaction. ml: Match is determined through machine learning algorithms for classification. none: Match is not found. \n", "enum": [ "merchantFull", "merchantPartial", "mcc", "ml", "none" ], "example": "merchantfull" }, "matchScore": { "type": "string", "description": "The confidence score for the matchType which is a float value between 0 and 1. The higher the number, the higher the confidence in the match.", "example": "1.0" }, "mcc": { "type": "object", "description": "Merchant category codes returned from Data holders.", "properties": { "code": { "type": "string", "description": "code", "example": "txMccCode-25028" }, "title": { "type": "string", "description": "title", "example": "" } } }, "anzsic": { "type": "object", "properties": { "division": { "type": "object", "properties": { "title": { "type": "string", "description": "Division Details", "example": "Accommodation and Food Services" }, "code": { "type": "string", "description": "Division Code", "example": "H" } }, "x-readme-ref-name": "TransactionsDivision" }, "subdivision": { "type": "object", "properties": { "code": { "type": "string", "description": "Subdivision Code", "example": "45" }, "title": { "type": "string", "description": "Subdivision Details", "example": "Food and Beverage Services" } }, "x-readme-ref-name": "TransactionsSubdivision" }, "group": { "type": "object", "properties": { "code": { "type": "string", "description": "Group Code", "example": "451" }, "title": { "type": "string", "description": "Group Details", "example": "Cafes, Restaurants and Takeaway Food Services" } }, "x-readme-ref-name": "TransactionsGroup" }, "class": { "type": "object", "properties": { "title": { "type": "string", "description": "Class Details", "example": "Cafes and Restaurants" }, "code": { "type": "string", "description": "Class Code", "example": "4511" } }, "x-readme-ref-name": "TransactionsClass" }, "subclass": { "type": "object", "properties": { "title": { "type": "string", "description": "SubClass Details", "example": "Cafes and Restaurants" }, "code": { "type": "string", "description": "SubClass Code", "example": "451100" } }, "x-readme-ref-name": "TransactionsSubClass" } }, "x-readme-ref-name": "TransactionsAnzsic" } }, "x-readme-ref-name": "TransactionsCategory" } }, "x-readme-ref-name": "TransactionsEnrich" }, "links": { "required": [ "account", "connection", "institution", "self" ], "type": "object", "properties": { "account": { "type": "string", "description": "Url of the account.", "example": "https://au-api.basiq.io/users/6a52015e/accounts/31eb30a0" }, "institution": { "type": "string", "description": "Url of the institution.", "example": "https://au-api.basiq.io/institutions/AU00000" }, "self": { "type": "string", "description": "Transaction self reference.", "example": "https://au-api.basiq.io/users/6a52015e/transactions/2082c765" } }, "x-readme-ref-name": "TransactionLinks" } }, "x-readme-ref-name": "TransactionData" } }, "links": { "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "Self reference url.", "example": "https://au-api.basiq.io/users/ea3a81/transactions" }, "next": { "type": "string", "description": "URL to the next result page when there are more than 500 transactions.", "example": "https://au-api.basiq.io/users/6a52015e/transactions?next=bf1ec9d4" } }, "x-readme-ref-name": "TransactionsGetLinks" } }, "description": "A transaction object is created whenever money is debited or credited from a particular account.", "x-readme-ref-name": "TransactionsGetResource" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" }, "examples": { "Bad Request": { "value": { "type": "list", "correlationId": "ac5ah5i", "data": [ { "type": "error", "title": "Parameter not valid.", "code": "parameter-not-valid", "detail": "ID value is not valid.", "source": { "parameter": "id" } } ] } }, "Invalid Filters": { "value": { "type": "list", "correlationId": "ac5ah55", "data": [ { "type": "error", "code": "parameter-not-valid", "title": "Parameter value is not valid", "detail": "The provided filter parameter is in invalid format or unsupported", "source": { "parameter": "filter" } } ] } } } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } } }, "security": [ { "services_token": [] } ] } }, "/users/{userId}/transactions/{transactionId}": { "get": { "tags": [ "Transactions" ], "summary": "Retrieve a transaction", "description": "Retrieve an existing transaction", "operationId": "getTransaction", "parameters": [ { "name": "userId", "in": "path", "description": "The identifier of the user.", "required": true, "schema": { "type": "string" } }, { "name": "transactionId", "in": "path", "description": "The identifier of the transaction.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns a transaction if a valid transaction ID was provided.", "content": { "application/json": { "schema": { "required": [ "id", "status", "description", "reference", "account", "amount", "currency", "class", "subClass", "connection", "direction", "enrich", "institution", "links", "postDate", "transactionDate", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Value is \"transaction\".", "example": "transaction" }, "id": { "type": "string", "description": "Uniquely identifies the transaction for this connection. Note that when a connection is refreshed pending transactions will receive new id's, whilst posted transactions will receive the same id's as before the refresh.", "example": "d3de1ca1" }, "status": { "type": "string", "description": "Identifies if a transaction is pending or posted. A pending transaction is an approved debit or credit transaction that has not been fully processed yet (i.e. has not been posted). Note that pending transactions are not available for all institutions.", "example": "posted", "enum": [ "pending", "posted" ] }, "description": { "type": "string", "description": "The transaction description as submitted by the institution." }, "reference": { "type": "string", "description": "The reference for the transaction provided by the originating institution." }, "amount": { "type": "string", "description": "Transaction amount. Outgoing funds are expressed as negative values.", "example": "123.12" }, "currency": { "type": "string", "description": "Standard 3 character currency codes as per ISO-4217.", "enum": [ "AUD", "USD", "GBP" ] }, "account": { "type": "string", "description": "The id of the account resource the transaction belongs to.", "example": "d3de1ca1" }, "balance": { "type": "string", "description": "Account balance at the time the transaction was completed. Included for Web connection integrations. CDR does not supply transaction balance, so this field will be empty for CDR connections.", "example": "123.12" }, "direction": { "type": "string", "description": "Identifies if the transaction is of debit or credit type.", "example": "debit", "enum": [ "debit", "credit" ] }, "class": { "type": "string", "description": "Describes the class(type) of transaction.", "example": "payment", "enum": [ "bank-fee", "payment", "cash-withdrawal", "transfer", "loan-interest", "refund", "direct-credit", "interest", "loan-repayment" ] }, "institution": { "type": "string", "description": "The id of the institution resource the transaction originated from.", "example": "AU00000" }, "connection": { "type": "string", "description": "The id of the connection resource that was used to retrieve the transaction.", "example": "d3de1ca1" }, "transactionDate": { "type": "string", "description": "Date that the user executed the transaction as provided by the institution. Note that not all transactions provide this value (varies by institution) e.g. \"2017-11-10T00:00:00Z\"", "example": null }, "paymentDetails": { "type": "object", "properties": { "bpay": { "type": "object", "properties": { "billerCode": { "type": "string", "description": "BPAY Biller Code for the transaction." }, "billerName": { "type": "string", "description": "Name of the BPAY biller for the transaction." }, "crn": { "type": "string", "description": "CRN for the transaction." } } }, "apcaNumber": { "type": "string", "description": "6 Digit APCA number for the initiating institution. The field is fixed-width and padded with leading zeros if applicable.\n" } } }, "postDate": { "type": "string", "description": "Date the transaction was posted as provided by the institution. This value is null if the record is pending. e.g. \"2017-11-10T21:46:44Z\" or 2017-11-10T00:00:00Z.", "example": "2018-11-02T00:00:00Z" }, "subClass": { "type": "object", "description": "The subClass attribute will only return values for payment transactions (i.e. will be empty for all others) plus [new] bank fee transactions for those relating to account conduct such as account overdrawn and direct debit dishonours.", "properties": { "code": { "type": "string", "description": "code", "example": 722 }, "title": { "type": "string", "description": "SubClass title", "example": "Cafes and Restaurants" } } }, "enrich": { "required": [ "cleanDescription", "tags", "category", "location", "merchant" ], "type": "object", "properties": { "location": { "type": "object", "nullable": true, "properties": { "country": { "type": "string", "description": "Country", "example": "Australia" }, "formattedAddress": { "type": "string", "description": "Address", "example": "1/39 E Esplanade, Manly NSW 2095" }, "geometry": { "type": "object", "properties": { "lat": { "type": "string", "description": "Latitude", "example": "-33.79988520000001" }, "lng": { "type": "string", "description": "Longitude", "example": "151.2858021" } }, "x-readme-ref-name": "TransactionsGeometry" }, "postalCode": { "type": "string", "description": "Postal Code", "example": "2095" }, "route": { "type": "string", "description": "Route Name", "example": "E Esplanade" }, "routeNo": { "type": "string", "description": "Route Number", "example": "29" }, "state": { "type": "string", "description": "State", "example": "NSW" }, "suburb": { "type": "string", "description": "Suburb", "example": "Manly" } }, "x-readme-ref-name": "TransactionsLocation" }, "cleanDescription": { "type": "string", "description": "", "x-readme-ref-name": "TransactionscleanDescription" }, "tags": { "type": "array", "items": { "type": "string", "description": "This array contains tags that are formatted as `tag_name:tag_value`. Each `tag_name` corresponds to a specific category of transaction information, and the `tag_value` provides a detailed classification within that category.\n- For example, the `card` tag_name will have a 4-digit number as tag_value (e.g., \"card:4615\").\n- The `conduct` tag_name can have values like `card`, `overdrawn`, `cheque`, `atm`, `currency`, `late`, `admin`, `dishonour`, `interest` (e.g., \"conduct:cheque\").\n- The `governmentPayment` tag_name might have values such as `centrelink`, `centrelinkCarers`, `crisisSupport`, `education`, `familyAllowance`, `jobseekerPymt`, `medicare`, `newstart`, `pension`, `rentalAssistance`, `vetAffairs`, `youthAllowance` (e.g., \"governmentPayment:centrelink\").\n- The `income` tag_name could include values like `childSupport`, `insurance`, `investment`, `rent`, `salary`, `superannuation` (e.g., \"income:salary\").\n- The `liability` tag_name could include values like `afterpay`, `arl collect pty ltd`, `australian recoveries`, `axess`, `azora`, `baycorp`, `beforepay`, `brighte`, `bundll`, `cash converters`, `cash direct`, `cashngo`, `cash stop`, `cash train`, `ccc`, `cfmg pty ltd`, `charter mercantile`, `cigno`, `collectau`, `collection house`, `complete credit solutions`, `credit collection services`, `credit corp`, `creditline`, `deferit`, `dun and bradstreet`, `earnd`, `edstart`, `finance one`, `fundo`, `fupay`, `gem visa`, `humm`, `indebted`, `klarna`, `latitude`, `laybuy`, `limepay`, `lion finance`, `money3`, `moneyloop`, `mypaynow`, `nimble`, `nine25`, `openpay`, `panthera`, `payitlater`, `payright`, `pioneer credit`, `plenti`, `probe`, `q card`, `quickapay`, `spotmenow`, `sunshine loans`, `tapmypay`, `wagetap`, `wallet wizard`, `zip pay` (e.g., \"liability:afterpay\").\n- The `third-party` tag_name might include values like `apple pay`, `google`, `paypal`, `sp`, `sq` (e.g., \"third-party:paypal\").\n- The `creditCard` tag_name is used with the value `creditCard` (e.g., \"creditCard:creditCard\").\n- The `expense` tag_name is used with the value `rent` (e.g., \"expense:rent\").\n- The `loan` tag_name is used with the value `loan repayment` (e.g., \"loan:loan repayment\").\n- The `mortgage` tag_name could include values like `afg home loans`, `aims`, `amo group`, `athena`, `aussie`, `bluestone`, `clickloans`, `emoney`, `express reverse mortgage`, `firstmac`, `fox symes`, `freedom lend`, `freedom loans`, `funding`, `heartland reverse mortgages`, `homeloans`, `homestar`, `homestart`, `household capital`, `illawarra home loans`, `keystart`, `la trobe financial`, `liberty financial`, `loans`, `mortgage house`, `mortgage offset`, `mortgageport`, `mortgage repayment`, `onetwo`, `online home loans`, `pacific mortgage group`, `pepper money`, `qantas money`, `reduce home loans`, `resi`, `resimac`, `sucasa`, `switzer home loans`, `ticToc`, `unloan`, `vmg`, `well money` (e.g., \"mortgage:afg home loans\").\n", "example": "conduct:dishonour" }, "description": "This field contains an array of strings, each representing a specific tag for the transaction. The format of each string should be `tag_name:tag_value`, where `tag_name` defines the type of transaction (e.g., `card`, `income`, `mortgage`), and `tag_value` provides additional details (e.g., \"card:4615\"). The tags help classify and identify transactions based on various criteria.\n\n - card:4615\n - conduct:card\n - conduct:overdrawn\n - conduct:cheque\n - conduct:atm\n - conduct:currency\n - conduct:late\n - conduct:admin\n - conduct:dishonour\n - conduct:interest\n - governmentPayment:centrelink\n - governmentPayment:centrelinkCarers\n - governmentPayment:crisisSupport\n - governmentPayment:education\n - governmentPayment:familyAllowance\n - governmentPayment:jobseekerPymt\n - governmentPayment:medicare\n - governmentPayment:newstart\n - governmentPayment:pension\n - governmentPayment:rentalAssistance\n - governmentPayment:vetAffairs\n - governmentPayment:youthAllowance\n - income:childSupport\n - income:insurance\n - income:investment\n - income:rent\n - income:salary\n - income:superannuation\n - liability:afterpay\n - liability:arl collect pty ltd\n - liability:australian recoveries\n - liability:axess\n - liability:azora\n - liability:baycorp\n - liability:beforepay\n - liability:brighte\n - liability:bundll\n - liability:cash converters\n - liability:cash direct\n - liability:cashngo\n - liability:cash stop\n - liability:cash train\n - liability:ccc\n - liability:cfmg pty ltd\n - liability:charter mercantile\n - liability:cigno\n - liability:collectau\n - liability:collection house\n - liability:complete credit solutions\n - liability:credit collection services\n - liability:credit corp\n - liability:creditline\n - liability:deferit\n - liability:dun and bradstreet\n - liability:earnd\n - liability:edstart\n - liability:finance one\n - liability:fundo\n - liability:fupay\n - liability:gem visa\n - liability:humm\n - liability:indebted\n - liability:klarna\n - liability:latitude\n - liability:laybuy\n - liability:limepay\n - liability:lion finance\n - liability:money3\n - liability:moneyloop\n - liability:mypaynow\n - liability:nimble\n - liability:nine25\n - liability:openpay\n - liability:panthera\n - liability:payitlater\n - liability:payright\n - liability:pioneer credit\n - liability:plenti\n - liability:probe\n - liability:q card\n - liability:quickapay\n - liability:spotmenow\n - liability:sunshine loans\n - liability:tapmypay\n - liability:wagetap\n - liability:wallet wizard\n - liability:zip pay\n - third-party:apple pay\n - third-party:google\n - third-party:paypal\n - third-party:sp\n - third-party:sq\n - creditCard:creditCard\n - expense:rent\n - loan:loan repayment\n - mortgage:afg home loans\n - mortgage:aims\n - mortgage:amo group\n - mortgage:athena\n - mortgage:aussie\n - mortgage:bluestone\n - mortgage:clickloans\n - mortgage:emoney\n - mortgage:express reverse mortgage\n - mortgage:firstmac\n - mortgage:fox symes\n - mortgage:freedom lend\n - mortgage:freedom loans\n - mortgage:funding\n - mortgage:heartland reverse mortgages\n - mortgage:homeloans\n - mortgage:homestar\n - mortgage:homestart\n - mortgage:household capital\n - mortgage:illawarra home loans\n - mortgage:keystart\n - mortgage:la trobe financial\n - mortgage:liberty financial\n - mortgage:loans\n - mortgage:mortgage house\n - mortgage:mortgage offset\n - mortgage:mortgageport\n - mortgage:mortgage repayment\n - mortgage:onetwo\n - mortgage:online home loans\n - mortgage:pacific mortgage group\n - mortgage:pepper money\n - mortgage:qantas money\n - mortgage:reduce home loans\n - mortgage:resi\n - mortgage:resimac\n - mortgage:sucasa\n - mortgage:switzer home loans\n - mortgage:ticToc\n - mortgage:unloan\n - mortgage:vmg\n - mortgage:well money\n", "x-readme-ref-name": "Transactionstags" }, "merchant": { "required": [ "id", "businessName", "ABN", "website", "logoMaster", "logoThumb" ], "type": "object", "nullable": true, "properties": { "id": { "type": "string", "description": "id", "example": "ae4a051c-4791-11e8-8750-0a87c0279fe8" }, "businessName": { "type": "string", "description": "Merchant name", "example": "Garfish Manly" }, "ABN": { "type": "string", "description": "ABN", "example": "90065628864" }, "logoMaster": { "type": "string", "description": "full merchant logo", "example": "https://enrich-enrichmerchantslogobucket-x62p53eh5ld9.s3-ap-southeast-2.amazonaws.com/officeworks-master.png" }, "logoThumb": { "type": "string", "description": "thumbnail merchant logo", "example": "https://enrich-enrichmerchantslogobucket-x62p53eh5ld9.s3-ap-southeast-2.amazonaws.com/officeworks-thumb.png" }, "phoneNumber": { "type": "object", "properties": { "international": { "type": "string", "description": "International Phone Number", "example": "+61 2 9977 0707" }, "local": { "type": "string", "description": "Local Phone Number", "example": "(02) 9977 0707" } }, "x-readme-ref-name": "TransactionsPhoneNumber" }, "website": { "type": "string", "description": "Merchant Website", "example": "http://garfish.com.au/garfish-manly/" } }, "x-readme-ref-name": "TransactionsMerchant" }, "category": { "type": "object", "nullable": true, "properties": { "matchType": { "type": "string", "description": "Indicates the method used to match a payment transaction with a merchant or business classification code. Description for each enum; merchantFull: Indicates an exact match between the transaction and a known merchant in the database. merchantPartial: Suggests a partial match with a merchant, usually based on substring or fuzzy logic. mcc: Match is done using the Merchant Category Code associated with the transaction. ml: Match is determined through machine learning algorithms for classification. none: Match is not found. \n", "enum": [ "merchantFull", "merchantPartial", "mcc", "ml", "none" ], "example": "merchantfull" }, "matchScore": { "type": "string", "description": "The confidence score for the matchType which is a float value between 0 and 1. The higher the number, the higher the confidence in the match.", "example": "1.0" }, "mcc": { "type": "object", "description": "Merchant category codes returned from Data holders.", "properties": { "code": { "type": "string", "description": "code", "example": "txMccCode-25028" }, "title": { "type": "string", "description": "title", "example": "" } } }, "anzsic": { "type": "object", "properties": { "division": { "type": "object", "properties": { "title": { "type": "string", "description": "Division Details", "example": "Accommodation and Food Services" }, "code": { "type": "string", "description": "Division Code", "example": "H" } }, "x-readme-ref-name": "TransactionsDivision" }, "subdivision": { "type": "object", "properties": { "code": { "type": "string", "description": "Subdivision Code", "example": "45" }, "title": { "type": "string", "description": "Subdivision Details", "example": "Food and Beverage Services" } }, "x-readme-ref-name": "TransactionsSubdivision" }, "group": { "type": "object", "properties": { "code": { "type": "string", "description": "Group Code", "example": "451" }, "title": { "type": "string", "description": "Group Details", "example": "Cafes, Restaurants and Takeaway Food Services" } }, "x-readme-ref-name": "TransactionsGroup" }, "class": { "type": "object", "properties": { "title": { "type": "string", "description": "Class Details", "example": "Cafes and Restaurants" }, "code": { "type": "string", "description": "Class Code", "example": "4511" } }, "x-readme-ref-name": "TransactionsClass" }, "subclass": { "type": "object", "properties": { "title": { "type": "string", "description": "SubClass Details", "example": "Cafes and Restaurants" }, "code": { "type": "string", "description": "SubClass Code", "example": "451100" } }, "x-readme-ref-name": "TransactionsSubClass" } }, "x-readme-ref-name": "TransactionsAnzsic" } }, "x-readme-ref-name": "TransactionsCategory" } }, "x-readme-ref-name": "TransactionsEnrich" }, "links": { "required": [ "account", "connection", "institution", "self" ], "type": "object", "properties": { "account": { "type": "string", "description": "Url of the account.", "example": "https://au-api.basiq.io/users/6a52015e/accounts/31eb30a0" }, "institution": { "type": "string", "description": "Url of the institution.", "example": "https://au-api.basiq.io/institutions/AU00000" }, "self": { "type": "string", "description": "Transaction self reference.", "example": "https://au-api.basiq.io/users/6a52015e/transactions/2082c765" } }, "x-readme-ref-name": "TransactionLinks" } }, "x-readme-ref-name": "TransactionData" } } } }, "400": { "description": "Returns error that server cannot or will not process the request due to something that is perceived to be a client error.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "The provided filter parameter is in invalid format or unsupported." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "BadRequestError" } } } }, "403": { "description": "Error that access is forbidden and tied to the application logic, such as insufficient rights to a resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "userId" }, "pointer": { "type": "string", "description": "Location to the object or attribute that the error relates to.", "example": "users/userId" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "ForbiddenAccessError" } } } }, "404": { "description": "Returns error indicating that server can't find requested resource.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "NotFoundError" } } } }, "500": { "description": "Returns error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "InternalServerError" } } } }, "503": { "description": "Returns error response code indicates that the server is not ready to handle the request.", "content": { "application/json": { "schema": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" } } } } }, "security": [ { "services_token": [] } ] } } }, "components": { "schemas": { "job": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "partnerId": { "type": "string" }, "status": { "type": "string" }, "jobType": { "type": "string" }, "applicationId": { "type": "string" }, "created": { "description": "date and time in ISO format of when the job request was created", "type": "string", "format": "date-time" }, "updated": { "description": "date and time in ISO format of when the job request was updated", "type": "string", "format": "date-time" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "result": { "type": "object", "nullable": true, "properties": { "type": { "type": "string" }, "url": { "type": "string" }, "code": { "type": "string" }, "title": { "type": "string" }, "detail": { "type": "string" } } } } } }, "links": { "type": "object", "properties": { "link": { "type": "string" }, "self": { "type": "string" }, "source": { "type": "string" } } } }, "x-readme-ref-name": "job" }, "StatementJobs": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "createdDate": { "description": "date and time in ISO format of when the job request was created", "type": "string", "format": "date-time" }, "updatedDate": { "description": "date and time in ISO format of when the job request was updated", "type": "string", "format": "date-time" }, "jobType": { "type": "string" }, "sourceId": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "result": { "type": "object", "nullable": true, "properties": { "type": { "type": "string" }, "url": { "type": "string" } } } } } }, "links": { "type": "object", "properties": { "link": { "type": "string" }, "self": { "type": "string" }, "source": { "type": "string" } } } }, "x-readme-ref-name": "StatementJobs" }, "ReportsJob": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "partnerId": { "type": "string" }, "applicationId": { "type": "string" }, "created": { "type": "string" }, "updated": { "type": "string" }, "status": { "type": "string" }, "jobType": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "status": { "type": "string" }, "result": { "type": "object", "properties": { "type": { "type": "string" }, "url": { "type": "string" } } } } } }, "links": { "type": "object", "properties": { "self": { "type": "string" }, "source": { "type": "string" } } } }, "x-readme-ref-name": "ReportsJob" }, "EventTypes": { "properties": { "type": { "type": "string" }, "count": { "type": "integer" }, "size": { "type": "integer" }, "data": { "type": "array", "description": "one or more events that the webhook would send messages for.", "items": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string", "description": "Identifer of the event type", "example": "user.created" }, "description": { "type": "string", "description": "a brief description of the event type", "example": "when a user is created" }, "links": { "type": "object", "properties": { "self": { "type": "string" } } } }, "x-readme-ref-name": "EventType" } }, "links": { "type": "object", "properties": { "self": { "type": "string" }, "next": { "type": "string" } } } }, "x-readme-ref-name": "EventTypes" }, "Error": { "properties": { "type": { "type": "string" }, "correlationId": { "type": "string" }, "data": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "code": { "type": "string" }, "title": { "type": "string" }, "detail": { "type": "string" }, "source": { "type": "object", "properties": { "parameter": { "type": "string" } } } } } } }, "x-readme-ref-name": "Error" }, "EventType": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string", "description": "Identifer of the event type", "example": "user.created" }, "description": { "type": "string", "description": "a brief description of the event type", "example": "when a user is created" }, "links": { "type": "object", "properties": { "self": { "type": "string" } } } }, "x-readme-ref-name": "EventType" }, "RetrieveEvent": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "createdDate": { "type": "string" }, "entity": { "type": "string" }, "eventType": { "type": "string" }, "userId": { "type": "string" }, "dataRef": { "type": "string" }, "data": { "type": "object", "properties": { "createdDate": { "type": "string" }, "id": { "type": "string" }, "institution": { "type": "object", "properties": { "id": { "type": "string" }, "links": { "type": "object", "properties": { "self": { "type": "string" } } }, "type": { "type": "string" } } }, "lastUsed": { "type": "string" }, "links": { "type": "object", "properties": { "accounts": { "type": "string" }, "self": { "type": "string" }, "transactions": { "type": "string" } } }, "mfaEnabled": { "type": "boolean" }, "status": { "type": "string" }, "type": { "type": "string" } } }, "links": { "type": "object", "properties": { "self": { "type": "string" } } } }, "x-readme-ref-name": "RetrieveEvent" }, "AuthLinksResponseResource": { "required": [ "id", "mobile", "type", "expiresAt", "userId" ], "type": "object", "properties": { "id": { "type": "string", "description": "Uniquely identifies the auth link.", "example": "63448be4" }, "mobile": { "type": "string", "description": "A user's mobile phone, used as for authentication.", "example": 61410000000 }, "type": { "type": "string", "description": "Type of the response, always \"auth_link\".", "example": "auth_link" }, "userId": { "type": "string", "description": "A string that uniquely identifies the user.", "example": "ec4ea48d" }, "expiresAt": { "type": "string", "description": "The date time of auth link expiry.", "example": "2019-11-21T04:08:50Z" }, "links": { "required": [ "public", "self" ], "type": "object", "properties": { "public": { "type": "string", "description": "Public URL of auth link.", "example": "https://connect.basiq.io/63448be4" }, "self": { "type": "string", "description": "URL of the resource", "example": "/users/ec4ea48d/auth_link" } }, "x-readme-ref-name": "AuthLinkLinks" } }, "x-readme-ref-name": "AuthLinksResponseResource" }, "GoneError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-no-longer-available", "enum": [ "resource-no-longer-available" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem." }, "title": { "type": "string", "description": "Title of the error" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "GoneError" }, "BadRequestError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Parameter not valid." }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "parameter-not-valid", "enum": [ "parameter-not-supplied", "parameter-not-valid", "unsupported-accept", "invalid-content", "institution-not-supported", "invalid-credentials" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "ID value is not valid." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "BadRequestError" }, "AuthLinkLinks": { "required": [ "public", "self" ], "type": "object", "properties": { "public": { "type": "string", "description": "Public URL of auth link.", "example": "https://connect.basiq.io/63448be4" }, "self": { "type": "string", "description": "URL of the resource", "example": "/users/ec4ea48d/auth_link" } }, "x-readme-ref-name": "AuthLinkLinks" }, "AuthLinksPostResponseResource": { "required": [ "mobile", "type", "userId", "expiresAt" ], "type": "object", "properties": { "mobile": { "type": "string", "description": "A user's mobile phone, used as for authentication.", "example": 61410000000 }, "type": { "type": "string", "description": "Type of the response, always \"auth_link\".", "example": "auth_link" }, "userId": { "type": "string", "description": "A string that uniquely identifies the user.", "example": "ec4ea48d" }, "expiresAt": { "type": "string", "description": "The date time of auth link expiry.", "example": "2019-11-21T04:08:50Z" }, "links": { "required": [ "public", "self" ], "type": "object", "properties": { "public": { "type": "string", "description": "Public URL of auth link.", "example": "https://connect.basiq.io/63448be4" }, "self": { "type": "string", "description": "URL of the resource", "example": "/users/ec4ea48d/auth_link" } }, "x-readme-ref-name": "AuthLinkLinks" } }, "x-readme-ref-name": "AuthLinksPostResponseResource" }, "ConnectionResponseResource": { "title": "ConnectionResponseResource", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"job\".", "example": "job" }, "id": { "type": "string", "description": "Job identification.", "example": "29523951" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing details for connection post.", "x-readme-ref-name": "ConnectionResponseResource" }, "EventsData": { "required": [ "createdDate", "id", "links", "type", "entity", "userId", "dataRef", "data", "eventType" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"event\".", "example": "event" }, "id": { "type": "string", "description": "Event identification.", "example": "61723" }, "createdDate": { "type": "string", "description": "Date the event was created.", "example": "2019-07-29T07:34:09Z" }, "entity": { "type": "string", "description": "The entity associated with the event that has occurred", "example": "consent", "enum": [ "consent", "connection" ] }, "eventType": { "type": "string", "description": "The type of event that has occurred", "example": "revoked", "enum": [ "revoked", "expired", "updated", "created", "archived", "deleted" ] }, "userId": { "type": "string", "description": "The identifier of the user the event belongs to.", "example": "266f5849-6ef6-4aae-accf-386470d0598e" }, "dataRef": { "type": "string", "description": "URL to the data source the event occurred.", "example": "https://au-api.basiq.io/users/266f5849-6ef6-4aae-accf-386470d0598e" }, "data": { "type": "string", "description": "The data associated with the event that has been created.", "example": [ { "email": "max@hooli.com", "id": "266f5849-6ef6-4aae-accf-386470d0598e", "links": { "self": "https://au-api.basiq.io/users/266f5849-6ef6-4aae-accf-386470d0598e" }, "mobile": "+614xxxxxxxx", "type": "user" } ] }, "links": { "example": [ { "self": "https://au-api.basiq.io/events/545ae104289e71bd3da34a063aaf49a5fa17ab6b8e0cab4bc56e019b7cc409e0" } ] } }, "x-readme-ref-name": "EventsData" }, "EventsGetResponseResource": { "title": "EventsGetResponseResource", "required": [ "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"list\".", "example": "list" }, "data": { "type": "array", "items": { "required": [ "createdDate", "id", "links", "type", "entity", "userId", "dataRef", "data", "eventType" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type, always \"event\".", "example": "event" }, "id": { "type": "string", "description": "Event identification.", "example": "61723" }, "createdDate": { "type": "string", "description": "Date the event was created.", "example": "2019-07-29T07:34:09Z" }, "entity": { "type": "string", "description": "The entity associated with the event that has occurred", "example": "consent", "enum": [ "consent", "connection" ] }, "eventType": { "type": "string", "description": "The type of event that has occurred", "example": "revoked", "enum": [ "revoked", "expired", "updated", "created", "archived", "deleted" ] }, "userId": { "type": "string", "description": "The identifier of the user the event belongs to.", "example": "266f5849-6ef6-4aae-accf-386470d0598e" }, "dataRef": { "type": "string", "description": "URL to the data source the event occurred.", "example": "https://au-api.basiq.io/users/266f5849-6ef6-4aae-accf-386470d0598e" }, "data": { "type": "string", "description": "The data associated with the event that has been created.", "example": [ { "email": "max@hooli.com", "id": "266f5849-6ef6-4aae-accf-386470d0598e", "links": { "self": "https://au-api.basiq.io/users/266f5849-6ef6-4aae-accf-386470d0598e" }, "mobile": "+614xxxxxxxx", "type": "user" } ] }, "links": { "example": [ { "self": "https://au-api.basiq.io/events/545ae104289e71bd3da34a063aaf49a5fa17ab6b8e0cab4bc56e019b7cc409e0" } ] } }, "x-readme-ref-name": "EventsData" } }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing details for connections.", "x-readme-ref-name": "EventsGetResponseResource" }, "ForbiddenAccessError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "source", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" }, "title": { "type": "string", "description": "Title of the error", "example": "Forbidden Access" }, "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "forbidden-access", "enum": [ "forbidden-access", "no-production-access", "access-denied" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Access to this resource is forbidden." }, "source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" } } } } }, "x-readme-ref-name": "ForbiddenAccessError" }, "GetUserAccount": { "title": "UserGetAccount", "required": [ "count", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of accounts.", "format": "int64", "example": 7 }, "data": { "type": "array", "description": "Accounts data.", "items": { "title": "UserGetAccountData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Account identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing account data.", "x-readme-ref-name": "GetUserAccountData" } } }, "description": "Container object containing account data.", "x-readme-ref-name": "GetUserAccount" }, "GetUserAccountData": { "title": "UserGetAccountData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Account identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing account data.", "x-readme-ref-name": "GetUserAccountData" }, "GetUserConnection": { "title": "UserGetConnection", "required": [ "count", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of accounts.", "format": "int64", "example": 5 }, "data": { "type": "array", "description": "Connections data.", "items": { "title": "GetUserConnectionData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"connection\".", "example": "connection" }, "id": { "type": "string", "description": "Connection identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing connection data.", "x-readme-ref-name": "GetUserConnectionData" } } }, "description": "Container object containing connection data.", "x-readme-ref-name": "GetUserConnection" }, "GetUserConnectionData": { "title": "GetUserConnectionData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"connection\".", "example": "connection" }, "id": { "type": "string", "description": "Connection identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing connection data.", "x-readme-ref-name": "GetUserConnectionData" }, "GetUserLinks": { "title": "GetUserLinks", "required": [ "accounts", "auth_link", "connections", "self", "transactions" ], "type": "object", "properties": { "accounts": { "type": "string", "description": "Accounts reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/accounts" }, "connections": { "type": "string", "description": "Connections reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/connections" }, "self": { "type": "string", "description": "User self reference url.", "example": "https://au-api.basiq.io/user/a3dgf4567a89" }, "transactions": { "type": "string", "description": "Transactions reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/transactions" } }, "description": "Object containing links to resources.", "x-readme-ref-name": "GetUserLinks" }, "InternalServerError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "internal-server-error", "enum": [ "internal-server-error" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Internal Server error. Contact support." }, "title": { "type": "string", "description": "Title of the error", "example": "Internal Server error." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "InternalServerError" }, "JobsData": { "title": "JobsData", "required": [ "created", "id", "institution", "steps", "updated" ], "type": "object", "properties": { "type": { "type": "string", "description": "Value is \"job\".", "example": "job" }, "id": { "type": "string", "description": "A string that uniquely identifies the job.", "example": "e9132638" }, "created": { "type": "string", "description": "The date time when the job was created.", "example": "2020-06-10T09:59:00Z" }, "updated": { "type": "string", "description": "The date time when the job was last updated.", "example": "2020-06-10T09:59:00Z" }, "institution": { "title": "Institution", "required": [ "id", "links", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "A string that uniquely identifies institution.", "example": "AU00000" }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" }, "type": { "type": "string", "description": "Always \"institution\".", "example": "institution" } }, "description": "Institution details.", "x-readme-ref-name": "JobsInstitution" }, "steps": { "type": "array", "description": "List of steps that need to be completed.", "items": { "title": "JobsStep", "required": [ "result", "status" ], "type": "object", "properties": { "title": { "type": "string", "description": "Name of the step the job needs to complete.", "example": "retrieve-accounts", "enum": [ "verify-credentials", "retrieve-accounts", "retrieve-transactions", "retrieve-statements" ] }, "status": { "type": "string", "description": "Status of the job step", "example": "success", "enum": [ "pending", "in-progress", "success", "failed" ] }, "result": { "title": "JobsResult", "type": "object", "properties": { "code": { "type": "string", "description": "In case of failed job, displays error code.", "enum": [ "success", "user-action-required", "system-unavailable", "maintenance", "connector-error", "institution-not-found", "institution-not-available", "institution-disabled", "missing-required-field", "missing-required-field-value", "invalid-field-value", "invalid-csv-row", "row-count-exceeded", "account-data-differs", "empty-file", "bank-statement-invalid", "bank-statement-new-product", "bank-statement-parsing-error", "bank-statement-not-supported", "txn-after-last-updated-date", "invalid-connection", "unknown-error", "job-timed-out" ] }, "details": { "type": "string", "description": "In case of failed job, displays details of the error." }, "title": { "type": "string", "description": "In case of failed job, displays error title." }, "type": { "type": "string", "description": "In case of success, Always \"link\".", "example": "link" }, "url": { "type": "string", "description": "In case of success, URL of the updated (or created) resources." } }, "description": "Result object containing a list of URLs or null. Otherwise if a step failed contains an error response.", "x-readme-ref-name": "JobsResult" } }, "description": "List of steps that need to be completed.", "x-readme-ref-name": "JobsStep" } }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" } }, "description": "Container object, containing job details.", "x-readme-ref-name": "JobsData" }, "JobPostRequest": { "required": [ "mfa-response" ], "type": "object", "properties": { "mfa-response": { "type": "array", "description": "One time password or answer to a security question/s e.g. [\"1234\"]", "example": [ "1234" ], "items": { "type": "string" } } }, "x-readme-ref-name": "JobPostRequest" }, "JobsInstitution": { "title": "Institution", "required": [ "id", "links", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "A string that uniquely identifies institution.", "example": "AU00000" }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" }, "type": { "type": "string", "description": "Always \"institution\".", "example": "institution" } }, "description": "Institution details.", "x-readme-ref-name": "JobsInstitution" }, "JobsLinks": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" }, "JobsResponseResource": { "required": [ "data", "links", "size", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"list\".", "example": "list" }, "data": { "type": "array", "description": "Container object, containing job details.", "items": { "title": "JobsData", "required": [ "created", "id", "institution", "steps", "updated" ], "type": "object", "properties": { "type": { "type": "string", "description": "Value is \"job\".", "example": "job" }, "id": { "type": "string", "description": "A string that uniquely identifies the job.", "example": "e9132638" }, "created": { "type": "string", "description": "The date time when the job was created.", "example": "2020-06-10T09:59:00Z" }, "updated": { "type": "string", "description": "The date time when the job was last updated.", "example": "2020-06-10T09:59:00Z" }, "institution": { "title": "Institution", "required": [ "id", "links", "type" ], "type": "object", "properties": { "id": { "type": "string", "description": "A string that uniquely identifies institution.", "example": "AU00000" }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" }, "type": { "type": "string", "description": "Always \"institution\".", "example": "institution" } }, "description": "Institution details.", "x-readme-ref-name": "JobsInstitution" }, "steps": { "type": "array", "description": "List of steps that need to be completed.", "items": { "title": "JobsStep", "required": [ "result", "status" ], "type": "object", "properties": { "title": { "type": "string", "description": "Name of the step the job needs to complete.", "example": "retrieve-accounts", "enum": [ "verify-credentials", "retrieve-accounts", "retrieve-transactions", "retrieve-statements" ] }, "status": { "type": "string", "description": "Status of the job step", "example": "success", "enum": [ "pending", "in-progress", "success", "failed" ] }, "result": { "title": "JobsResult", "type": "object", "properties": { "code": { "type": "string", "description": "In case of failed job, displays error code.", "enum": [ "success", "user-action-required", "system-unavailable", "maintenance", "connector-error", "institution-not-found", "institution-not-available", "institution-disabled", "missing-required-field", "missing-required-field-value", "invalid-field-value", "invalid-csv-row", "row-count-exceeded", "account-data-differs", "empty-file", "bank-statement-invalid", "bank-statement-new-product", "bank-statement-parsing-error", "bank-statement-not-supported", "txn-after-last-updated-date", "invalid-connection", "unknown-error", "job-timed-out" ] }, "details": { "type": "string", "description": "In case of failed job, displays details of the error." }, "title": { "type": "string", "description": "In case of failed job, displays error title." }, "type": { "type": "string", "description": "In case of success, Always \"link\".", "example": "link" }, "url": { "type": "string", "description": "In case of success, URL of the updated (or created) resources." } }, "description": "Result object containing a list of URLs or null. Otherwise if a step failed contains an error response.", "x-readme-ref-name": "JobsResult" } }, "description": "List of steps that need to be completed.", "x-readme-ref-name": "JobsStep" } }, "links": { "title": "JobsLinks", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource", "example": "https://au-api.basiq.io/jobs/61723" }, "source": { "type": "string", "description": "Resource that initiated creation of this Job. For example, for operations on Connection, this is a Connection URL. This is only returned for Connection jobs and not for Statement jobs.", "example": "https://au-api.basiq.io/users/ea3a81/connections/8fce3b" } }, "description": "Links to the resources.", "x-readme-ref-name": "JobsLinks" } }, "description": "Container object, containing job details.", "x-readme-ref-name": "JobsData" } }, "size": { "type": "integer", "description": "Size of the all the jobs.", "format": "int64", "example": 100 }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "x-readme-ref-name": "JobsResponseResource" }, "JobsResult": { "title": "JobsResult", "type": "object", "properties": { "code": { "type": "string", "description": "In case of failed job, displays error code.", "enum": [ "success", "user-action-required", "system-unavailable", "maintenance", "connector-error", "institution-not-found", "institution-not-available", "institution-disabled", "missing-required-field", "missing-required-field-value", "invalid-field-value", "invalid-csv-row", "row-count-exceeded", "account-data-differs", "empty-file", "bank-statement-invalid", "bank-statement-new-product", "bank-statement-parsing-error", "bank-statement-not-supported", "txn-after-last-updated-date", "invalid-connection", "unknown-error", "job-timed-out" ] }, "details": { "type": "string", "description": "In case of failed job, displays details of the error." }, "title": { "type": "string", "description": "In case of failed job, displays error title." }, "type": { "type": "string", "description": "In case of success, Always \"link\".", "example": "link" }, "url": { "type": "string", "description": "In case of success, URL of the updated (or created) resources." } }, "description": "Result object containing a list of URLs or null. Otherwise if a step failed contains an error response.", "x-readme-ref-name": "JobsResult" }, "JobsStep": { "title": "JobsStep", "required": [ "result", "status" ], "type": "object", "properties": { "title": { "type": "string", "description": "Name of the step the job needs to complete.", "example": "retrieve-accounts", "enum": [ "verify-credentials", "retrieve-accounts", "retrieve-transactions", "retrieve-statements" ] }, "status": { "type": "string", "description": "Status of the job step", "example": "success", "enum": [ "pending", "in-progress", "success", "failed" ] }, "result": { "title": "JobsResult", "type": "object", "properties": { "code": { "type": "string", "description": "In case of failed job, displays error code.", "enum": [ "success", "user-action-required", "system-unavailable", "maintenance", "connector-error", "institution-not-found", "institution-not-available", "institution-disabled", "missing-required-field", "missing-required-field-value", "invalid-field-value", "invalid-csv-row", "row-count-exceeded", "account-data-differs", "empty-file", "bank-statement-invalid", "bank-statement-new-product", "bank-statement-parsing-error", "bank-statement-not-supported", "txn-after-last-updated-date", "invalid-connection", "unknown-error", "job-timed-out" ] }, "details": { "type": "string", "description": "In case of failed job, displays details of the error." }, "title": { "type": "string", "description": "In case of failed job, displays error title." }, "type": { "type": "string", "description": "In case of success, Always \"link\".", "example": "link" }, "url": { "type": "string", "description": "In case of success, URL of the updated (or created) resources." } }, "description": "Result object containing a list of URLs or null. Otherwise if a step failed contains an error response.", "x-readme-ref-name": "JobsResult" } }, "description": "List of steps that need to be completed.", "x-readme-ref-name": "JobsStep" }, "NotFoundError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "resource-not-found", "enum": [ "resource-not-found" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Resource not found." }, "title": { "type": "string", "description": "Title of the error", "example": "Requested resource is not found." }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "NotFoundError" }, "ResourceLink": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" }, "Source": { "title": "Source", "type": "object", "properties": { "parameter": { "type": "string", "description": "String indicating which URI query parameter caused the error.", "example": "id" } }, "description": "An object containing references to the source of the error.", "x-readme-ref-name": "Source" }, "StatusServiceUnavailableError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "object", "description": "Application-specific error code, expressed as a string value.", "example": "service-unavailable" }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "Service Unavailable. Try again later." }, "title": { "type": "string", "description": "Title of the error", "example": "Service Unavailable" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } } }, "x-readme-ref-name": "StatusServiceUnavailableError" }, "UnauthorizedError": { "required": [ "correlationId", "data", "type" ], "type": "object", "properties": { "correlationId": { "type": "string", "description": "Unique identifier for this particular occurrence of the problem.", "example": "ac5ah5i" }, "data": { "type": "array", "description": "Error data.", "items": { "required": [ "code", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "Application-specific error code, expressed as a string value.", "example": "unauthorized-access", "enum": [ "unauthorized-access", "invalid-authorization-token" ] }, "detail": { "type": "string", "description": "Human-readable explanation specific to this occurrence of the problem.", "example": "You are not authorized to access this resource" }, "title": { "type": "string", "description": "Title of the error", "example": "Unauthorized Access" }, "type": { "type": "string", "description": "Type of the response, always \"error\"", "example": "error" } } } }, "type": { "type": "string", "description": "Always \"list\".", "example": "list" } }, "x-readme-ref-name": "UnauthorizedError" }, "UserGetResponse": { "title": "UserGetResponse", "required": [ "accounts", "connections", "email", "id", "links", "mobile", "name", "firstName", "middleName", "lastName", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"user\".", "example": "user" }, "id": { "type": "string", "description": "User identification.", "example": "ea3a81" }, "email": { "type": "string", "description": "User email or empty.", "format": "email", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "User mobile number, or empty.", "example": 61410888666 }, "name": { "type": "string", "description": "Name, or empty.", "example": "" }, "firstName": { "type": "string", "description": "firstName, or empty", "example": "Gavin" }, "middleName": { "type": "string", "description": "middleName, or empty", "example": "middleName" }, "lastName": { "type": "string", "description": "lastName, or empty", "example": "lastName" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." }, "connections": { "title": "UserGetConnection", "required": [ "count", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of accounts.", "format": "int64", "example": 5 }, "data": { "type": "array", "description": "Connections data.", "items": { "title": "GetUserConnectionData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"connection\".", "example": "connection" }, "id": { "type": "string", "description": "Connection identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing connection data.", "x-readme-ref-name": "GetUserConnectionData" } } }, "description": "Container object containing connection data.", "x-readme-ref-name": "GetUserConnection" }, "accounts": { "title": "UserGetAccount", "required": [ "count", "data", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"list\".", "example": "list" }, "count": { "type": "integer", "description": "Count of accounts.", "format": "int64", "example": 7 }, "data": { "type": "array", "description": "Accounts data.", "items": { "title": "UserGetAccountData", "required": [ "id", "links", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Always \"account\".", "example": "account" }, "id": { "type": "string", "description": "Account identification.", "example": "aaaf2c3b" }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "Object containing account data.", "x-readme-ref-name": "GetUserAccountData" } } }, "description": "Container object containing account data.", "x-readme-ref-name": "GetUserAccount" }, "links": { "title": "GetUserLinks", "required": [ "accounts", "auth_link", "connections", "self", "transactions" ], "type": "object", "properties": { "accounts": { "type": "string", "description": "Accounts reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/accounts" }, "connections": { "type": "string", "description": "Connections reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/connections" }, "self": { "type": "string", "description": "User self reference url.", "example": "https://au-api.basiq.io/user/a3dgf4567a89" }, "transactions": { "type": "string", "description": "Transactions reference url.", "example": "https://au-api.basiq.io/users/a3dgf4567a89/transactions" } }, "description": "Object containing links to resources.", "x-readme-ref-name": "GetUserLinks" } }, "description": "User object with details if the creation succeeded.", "x-readme-ref-name": "UserGetResponse" }, "UserPostResponse": { "title": "UserPostResponse", "required": [ "id", "links", "mobile", "type" ], "type": "object", "properties": { "type": { "type": "string", "description": "Type of the response, always \"user\".", "example": "user" }, "id": { "type": "string", "description": "A string that uniquely identifies the user.", "example": "e1956419" }, "email": { "type": "string", "description": "The end-users email address.", "format": "email", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number.", "example": 61410888999 }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Gavin" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Belson" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." }, "links": { "title": "ResourceLink", "required": [ "self" ], "type": "object", "properties": { "self": { "type": "string", "description": "URL of the resource.", "example": "https://au-api.basiq.io/link/a3dgf4567a89" } }, "description": "Link object containing a link to the resource, self reference.", "x-readme-ref-name": "ResourceLink" } }, "description": "User object with details if the creation succeeded.", "x-readme-ref-name": "UserPostResponse" }, "createUser": { "type": "object", "properties": { "email": { "type": "string", "description": "The end-users email address. Mandatory if mobile is not supplied.", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number, supplied in international format. +[country-code][mobileno]. Mandatory if email is not supplied.", "example": "+61410888999" }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Gavin" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Belson" }, "businessName": { "type": "string", "description": "The official name of the business.", "example": "Manly Accounting PTY LTD" }, "businessIdNo": { "type": "string", "description": "This number is used to identify a business when they’re dealing with the government, other businesses, and the public.", "example": "16 7645 892" }, "businessIdNoType": { "type": "string", "description": "Type of business ID could be ABN Or ACN.", "enum": [ "ABN", "ACN" ], "example": "ABN" }, "businessAddress": { "type": "object", "properties": { "addressLine1": { "type": "string", "example": "21 Sydney Rd", "description": "The first line of the business address." }, "addressLine2": { "type": "string", "example": "", "description": "Additional information about the business address (optional)." }, "suburb": { "type": "string", "example": "Manly", "description": "The suburb or locality where the business is located." }, "state": { "type": "string", "example": "NSW", "description": "The state or territory where the business is located." }, "postcode": { "type": "string", "example": "2095", "description": "The postal code of the business location." }, "countryCode": { "type": "string", "example": "AUS", "description": "The country code of the business location." } } }, "verificationStatus": { "type": "boolean", "description": "Indicates if the business information provided is verified against the Australian Business Register." }, "verificationDate": { "type": "string", "example": "12/01/2024", "description": "when the verification was done." } }, "x-readme-ref-name": "createUser" }, "updateUser": { "type": "object", "properties": { "email": { "type": "string", "description": "The end-users email address.", "example": "gavin@hooli.com" }, "mobile": { "type": "string", "description": "The end-users mobile number.", "example": "+61410888666" }, "firstName": { "type": "string", "description": "The end-users first name as an optional additional parameter.", "example": "Malcolm" }, "middleName": { "type": "string", "description": "The end-users middle name as an optional additional parameter.", "example": "Malcom middle name" }, "lastName": { "type": "string", "description": "The end-users last name as an optional additional parameter.", "example": "Malcolm last name" } }, "x-readme-ref-name": "updateUser" }, "TokenPostResponse": { "required": [ "access_token", "expires_in", "token_type" ], "type": "object", "properties": { "access_token": { "type": "string", "description": "The generated access token.", "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" }, "expires_in": { "type": "integer", "description": "Expires in 3600 seconds", "format": "int64", "example": 3600 }, "token_type": { "type": "string", "description": "This value will always be `Bearer`.", "example": "Bearer" } }, "x-readme-ref-name": "TokenPostResponse" }, "UserConsentGetResponses": { "type": "object", "additionalProperties": false, "properties": { "type": { "type": "string" }, "id": { "type": "string", "format": "uuid" }, "created": { "type": "string", "format": "date-time" }, "updated": { "type": "string", "format": "date-time" }, "expiryDate": { "type": "string", "format": "date-time" }, "origin": { "type": "string" }, "status": { "type": "string", "description": "active, revoked, and expired" }, "purpose": { "type": "object", "additionalProperties": false, "properties": { "primary": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" }, "other": { "type": "boolean", "nullable": true } }, "required": [ "primary" ], "title": "Purpose", "x-readme-ref-name": "Purpose" }, "data": { "type": "object", "additionalProperties": false, "properties": { "retainData": { "type": "boolean" }, "initialRetrievalDays": { "type": "integer" }, "organisation": { "type": "boolean", "nullable": true }, "permissions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "scope": { "type": "string" }, "required": { "type": "boolean" }, "consented": { "type": "boolean" }, "entity": { "type": "string" }, "information": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "attributeList": { "type": "array", "items": { "type": "string" } } }, "required": [ "attributeList", "description", "name" ], "title": "Information", "x-readme-ref-name": "Information" }, "purpose": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" } }, "required": [ "entity", "information", "purpose", "required", "scope" ], "title": "Permission", "x-readme-ref-name": "Permission" } } }, "required": [ "permissions", "retainData" ], "title": "Data", "x-readme-ref-name": "Data" }, "revoked": { "type": "string", "description": "To indicate when a user consent was revoked." }, "links": { "type": "object", "properties": { "self": { "type": "string" }, "consentPolicy": { "type": "string" }, "latestConsentPolicy": { "type": "string" } } } }, "required": [ "created", "data", "expiryDate", "id", "purpose", "status", "type", "updated" ], "title": "UserConsentGetResponse", "x-readme-ref-name": "UserConsentGetResponses" }, "Data": { "type": "object", "additionalProperties": false, "properties": { "retainData": { "type": "boolean" }, "initialRetrievalDays": { "type": "integer" }, "organisation": { "type": "boolean", "nullable": true }, "permissions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "scope": { "type": "string" }, "required": { "type": "boolean" }, "consented": { "type": "boolean" }, "entity": { "type": "string" }, "information": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "attributeList": { "type": "array", "items": { "type": "string" } } }, "required": [ "attributeList", "description", "name" ], "title": "Information", "x-readme-ref-name": "Information" }, "purpose": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" } }, "required": [ "entity", "information", "purpose", "required", "scope" ], "title": "Permission", "x-readme-ref-name": "Permission" } } }, "required": [ "permissions", "retainData" ], "title": "Data", "x-readme-ref-name": "Data" }, "Permission": { "type": "object", "additionalProperties": false, "properties": { "scope": { "type": "string" }, "required": { "type": "boolean" }, "consented": { "type": "boolean" }, "entity": { "type": "string" }, "information": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "attributeList": { "type": "array", "items": { "type": "string" } } }, "required": [ "attributeList", "description", "name" ], "title": "Information", "x-readme-ref-name": "Information" }, "purpose": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" } }, "required": [ "entity", "information", "purpose", "required", "scope" ], "title": "Permission", "x-readme-ref-name": "Permission" }, "Information": { "type": "object", "additionalProperties": false, "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "attributeList": { "type": "array", "items": { "type": "string" } } }, "required": [ "attributeList", "description", "name" ], "title": "Information", "x-readme-ref-name": "Information" }, "Primary": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" }, "Purpose": { "type": "object", "additionalProperties": false, "properties": { "primary": { "type": "object", "additionalProperties": false, "properties": { "title": { "type": "string" }, "description": { "type": "string" } }, "required": [ "description", "title" ], "title": "Primary", "x-readme-ref-name": "Primary" }, "other": { "type": "boolean", "nullable": true } }, "required": [ "primary" ], "title": "Purpose", "x-readme-ref-name": "Purpose" } }, "securitySchemes": { "api_key": { "type": "apiKey", "name": "Authorization", "in": "header", "x-default": "Basic NjMxMjNmMWMtZjYxMy00ZjMyLWFiYzUtYzBhZDdhYTY2YmU1OjQ3NWYwMzhkLTBlZmItNGM1ZS1iMzQ0LTAzMzYxOTkyYTRlMw==" }, "services_token": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" } } }, "security": [ { "api_key": [] }, { "services_token": [] } ], "x-readme": { "explorer-enabled": true, "proxy-enabled": true, "samples-enabled": true, "samples-languages": [ "curl", "node", "ruby", "javascript", "python" ] } }