Get IntelliAppZ Customer Info
Overview
Retrieve an IntelliAppZ customer associated with the authenticated Implementation Partner using its customer ID.
Endpoint
GET /api/integration/partner/appzcustomer/byid
Use the service origin described in Getting started. The path above already includes /api.
Authentication
Send the access token obtained from Get Access Token in the Authorization header. Access is limited by the authenticated account’s permissions.
Request headers
Accept: application/json
Authorization: Bearer ACCESS_TOKEN
Query parameters
| Parameter | Type | Requirement | Description |
|---|---|---|---|
customerId | integer | Required | Customer ID associated with the authenticated partner. |
Request example
The following example uses cURL in a POSIX shell. Replace example credentials and IDs before running it.
curl --request GET \
--url 'https://accounts.onintellibuddies.com/api/integration/partner/appzcustomer/byid?customerId=1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ACCESS_TOKEN'
Response
Successful status: 200 OK.
The following is an illustrative response with synthetic contact and credential values. Arrays are shortened to one representative item.
{
"partner": {
"partnerId": 1,
"firstName": "Alex",
"lastName": "Example",
"emailAddress": "partner@example.com",
"phone": "+1-202-555-0100",
"jobTitle": "IntelliAppZ Implementation",
"companyName": "VIT",
"country": "India",
"city": "Bengaluru",
"industry": "Software & IT Services",
"businessRegion": "Western America;#India",
"partnerType": "Implementation Partner",
"status": "Active",
"number": "IBPR20250124000001",
"state": null,
"postalCode": null,
"address": null,
"created": "2025-01-24T13:02:53.665853",
"modified": "2025-01-24T13:13:22.204731",
"createdBy": "Sample User",
"modifiedBy": "Sample User"
},
"customers": [
{
"id": 1,
"name": "IAZCustomer",
"address": "123 Example Street",
"email": "partner@example.com",
"telephone": "+1-202-555-0100",
"business": "VIT IB",
"url": "",
"comments": "",
"state": null,
"country": null,
"city": null,
"postalCode": null,
"created": "2025-01-31T12:26:44.487833",
"modified": "2025-01-31T12:26:44.487833",
"createdBy": "Sample User",
"modifiedBy": "Sample User"
}
]
}
Response fields
The table describes selected fields in the response. Types reflect the example; this is not an exhaustive schema or nullability contract.
| Field | Example type | Description |
|---|---|---|
partner | object | Profile of the authenticated partner. |
customers | array | Customer records associated with the request. |
Errors
Documented error statuses are listed below. Exact response bodies and validation details are not documented.
| Status | Description |
|---|---|
| 400 | Bad Request – The partner ID or user ID is invalid. |
| 401 | Unauthorized – Authentication is required to access this resource. |
| 403 | Forbidden – The user lacks IntelliAppZ customers access or is not authenticated as a partner. |
| 404 | Not Found – No partner record is associated with the authenticated user. |
| 500 | Internal Server Error – An unexpected error occurred during request processing. |