## Getting Access

A **LANDATA Account** with web services access is required to use the Portal SOAP API. To request access, please contact: [data.services@servictoria.com.au](mailto:data.services@servictoria.com.au)

You will receive:

- An **Account ID** for identifying your organisation
- **Session credentials** for authentication
- Access to the Test environment for development and testing


## Authentication

The Portal SOAP API uses a session-based authentication model. Each SOAP request must include:

- `accountId` - Your assigned account identifier
- `sessionId` - A valid session ID obtained from the login process


### Session Management

Sessions are established through the LANDATA Portal login process and have a limited lifetime. Your application should:

1. Obtain a session ID through the authentication process
2. Include the session ID in all subsequent API calls
3. Handle session expiry by re-authenticating when necessary


### Request Structure

All Portal SOAP operations follow this general request structure:


```xml
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tns="http://Portal1.landata.vic.gov.au/Portal/WebServices">
  <soap:Body>
    <tns:OperationName>
      <tns:accountId>YOUR_ACCOUNT_ID</tns:accountId>
      <tns:sessionId>YOUR_SESSION_ID</tns:sessionId>
      <tns:customerReference>YOUR_REFERENCE</tns:customerReference>
      <!-- Operation-specific parameters -->
    </tns:OperationName>
  </soap:Body>
</soap:Envelope>
```

### Customer Reference

The `customerReference` parameter is optional but recommended. It allows you to:

- Track requests in your own systems
- Associate API calls with your internal order references
- Facilitate reconciliation and troubleshooting


## Environment URLs

| Environment | WSDL URL |
|  --- | --- |
| Test | `https://test.portal.landata.vic.gov.au/Portal/WebServices/Portal.svc?wsdl` |
| Production | `https://portal.landata.vic.gov.au/Portal/WebServices/Portal.svc?wsdl` |


## Rate Limits

The Portal SOAP API has rate limiting in place to ensure fair usage. If you receive rate limit errors, implement exponential backoff in your retry logic.

## More Information

For detailed WSDL specifications, see the [WSDL Reference](/assets/portal.10f55f4ef5a4844b66a8527b411b9d84d10a196a128b8b76ac1c702b571c63d8.64e2a0c4.wsdl).