List customer info - client mode

Production

https://api.mediaconnect.no/capi

GET

/v1/client/customer/info/{customerNumber}

Customer

Only the client needs to be logged in to use this endpoint. The user does not need to be logged in, click here to read more.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.mediaconnect.no/capi/v1/client/customer/info/'

Response Example

200 - Success

{
    "customerNumber": 563457,
    "name": {
        "firstName": "Ola",
        "middleName": "Fjordstrand",
        "lastName": "Nordmann",
        "companyName": "Company International Ltd",
        "departmentName": "Support"
    },
    "phoneNumbers": [
        {
            "phoneNumber": "+4712345678",
            "phoneNumberType": "personal"
        },
        {
            "phoneNumber": "+4723339100",
            "phoneNumberType": "company"
        }
    ],
    "emails": [
        "ola.nordmann@hotmail.no",
        "ola.nordmann@company.com"
    ],
    "invoiceEmailAddress": "ola.nordmann@hotmail.no",
    "attachedUsers": {
        "uniqueId": "abc123ee63461dd",
        "credentials": [
            {
                "credential": "ola.nordmann@hotmail.no",
                "credentialType": "A_EMAIL_ADDRESS",
                "verificationLevel": "Externally_verified"
            },
            {
                "credential": "+4790123456",
                "credentialType": "B_SMS_PHONE",
                "verificationLevel": "Not verified"
            }
        ]
    }
}

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://connectid.no/user/oauth/token

Refresh URL: https://connectid.no/user/oauth/token

Scopes:

read-For all access

Path Params

customerNumber

integer

required

Customer number

Responses

🟢200OK

application/json

Body

customerNumber

integer

optional

Customer number in the partner datastore

name

object (Name)

optional

firstName

string

optional

First name

<= 30 characters

middleName

string

optional

Middle name

<= 30 characters

lastName

string

optional

Last name

<= 30 characters

companyName

string

optional

Company name

<= 40 characters

departmentName

string

optional

Department name

<= 40 characters

phoneNumbers

array [object {2}]

optional

phoneNumber

string

optional

A phone number has to follow the telephone number standard E.164

<= 20 characters

phoneNumberType

enum<string>

optional

Phone number type:

home: Home or private number

mobile: Mobile number

companyDirect: Company or work number

companyPbx: Private number within company

company: A phone number you can call the customer at work.

personal: Personal phone number.

fax: A phone number to a fax machine.

Allowed values:

homemobilecompanyDirectcompanyPbxcompanypersonalfax

emails

array[string <email>]

optional

Email address (each email maximum 255 character)

invoiceEmailAddress

string <email>

optional

Email address that shall be used for sending email invoice

<= 60 characters

attachedUsers

array [object {2}]

optional

List of user ids connected to customer number

uniqueId

string

optional

External id for this user

credentials

array [object {3}]

optional

Credentials connected to this user

🟠400Bad Request

🟠404Record Not Found

🟠429429

🔴500Server Error

Check customer number - client mode

Remove external reference - client mode