This service privides the ability for agents, organistation or self-assessment individuals to search ETMP for their Business Partner
The request must be a valid json using one of the following uris
- POST /sa/:gg/business-matching/business-lookup/:utr/:userType: Self Assessment users should call this
- POST /org/:gg/business-matching/business-lookup/:utr/:userType: Organisations should call this
- POST /agent/:gg/business-matching/business-lookup/:utr/:userType: Agents should call this
Where:
| Parameter | Message |
|---|---|
| gg | The Users Government Gateway Id |
| utr | he Unique Tax Reference being looked up |
| userType | Whether this is "sa", "org" or "agent" |
####Example of usage
POST /agent/123456789/business-matching/business-lookup/:utr/agent
Request body
{
"acknowledgmentReference": "12345678901234123456789098909090",
"utr": "1234567890",
"requiresNameMatch": true,
"isAnAgent": true,
"individual": {
"firstName": "Stephen",
"lastName": "Wood",
"dateOfBirth": "1990-04-03"
}
}Response body
{
"sapNumber": "1234567890",
"safeId": "XE0001234567890",
"agentReferenceNumber": "AARN1234567",
"isEditable": true,
"isAnAgent": false,
"isAnIndividual": true,
"individual": {
"firstName": "Stephen",
"lastName": "Wood",
"dateOfBirth": "1990-04-03"
},
"address": {
"addressLine1": "100 SuttonStreet",
"addressLine2": "Wokingham",
"addressLine3": "Surrey",
"addressLine4": "London",
"postalCode": "DH14EJ",
"countryCode": "GB"
},
"contactDetails": {
"phoneNumber": "01332752856",
"mobileNumber": "07782565326",
"faxNumber": "01332754256",
"eMailAddress": "[email protected]"
}
}This code is open source software licensed under the Apache 2.0 License.