# Business contacts

Returns the contact details for a specific business.
**To access this Business Contacts endpoint the authorised user must have the Access Controller role in Class for the specified business.**

Endpoint: GET /b/{businessCode}/business-data/business-contacts
Version: 1.0
Security: Class_oAuth

## Security:

  - `Class_oAuth` (unknown)
    oauth2 scopes: business.details.read

## Path parameters:

  - `businessCode` (string, required)
    The unique identifier code for the Class business.

## Response 200:

  - `200` (unknown)
    Success (Ok)

## Response 200 fields (application/json):

  - `data` (array)
    A list of business contact details.

  - `data.id` (string)
    The unique identifier for the business contact.

  - `data.firstName` (string)
    The first name of the contact.

  - `data.middleNames` (string)
    The middle names of the contact.

  - `data.lastName` (string)
    The last name of the contact.

  - `data.organisationName` (string)
    The organisation name if the contact represents an entity.

  - `data.email` (string)
    The email address of the contact.

  - `data.partyRelationships` (array)
    A list of relationships or roles this contact holds.

  - `data.partyRelationships.roleType` (string)
    The role type assigned to the contact.

  - `data.partyRelationships.scope` (string)
    The specific scope identifier for the role.

  - `data.partyRelationships.scopeType` (string)
    The level or type of scope (e.g., Fund, Business).

  - `data.partyRelationships.invitationStatus` (string)
    The current status of the invitation for this role.

  - `Errors` (array)
    A collection of detailed error response objects.

  - `Errors.Code` (string, required)
    The unique error code identifier.

  - `Errors.Message` (string, required)
    A detailed human-readable message explaining the error.

## Response 400:

  - `400` (unknown)
    Error Message

## Response 400 fields (application/json):

  - `Errors` (array)
    A list of validation or request errors.

  - `Errors.code` (string)
    A specific alphanumeric code mapped to the validation failure.

  - `Errors.message` (string)
    A detailed explanation isolating the root cause of the validation failure.

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `Errors` (array)
    A list of authorization errors.

  - `Errors.Code` (string)
    The error code isolating authentication token absence or invalidity.
    Example: API_NOT_AUTHORISED

  - `Errors.Message` (string)
    A prompt message stating the client session must successfully authenticate first.
    Example: Not authorised

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `Errors` (array)
    A list of forbidden access errors.

  - `Errors.Code` (string)
    The standard error code emitted when a user lacks required system privileges.
    Example: FORBIDDEN

  - `Errors.Message` (string)
    A clear message detailing the denial of access based on permission models.
    Example: You do not have permission to access this resource.

## Response 404:

  - `404` (unknown)
    Resource not available or user does not have access to the business

## Response 404 fields (application/json):

  - `Errors` (array)
    A list of resource not found errors.

  - `Errors.Code` (string)
    The standard error code mapped to missing resources or denied visibility rights.
    Example: API_NOT_FOUND

  - `Errors.Message` (string)
    Information clarifying that the target resource cannot be found or viewed.
    Example: Resource not available or user does not have access to the fund.

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `Errors` (array)
    A list of internal server errors.

  - `Errors.Code` (string)
    The internal system error code signaling an unexpected failure.
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    The generic public message advising of an unanticipated backend error.
    Example: An unexpected error occurred on the server. Please try again later.

## Response default:

  - `default` (unknown)
    Unexpected error

## Response default fields (application/json):

  - `Errors` (array)
    A list of unexpected errors.

  - `Errors.Code` (string)
    The internal system error code signaling an unexpected failure.
    Example: API_INTERNAL_ERROR

  - `Errors.Message` (string)
    The generic public message advising of an unanticipated backend error.
    Example: An unexpected error occurred on the server. Please try again later.