GET/partners/customers

Gets a list of customers. The sort order may not be determined by the internal logic.

Caution
The productId property includes only the information about the LINE WORKS services.
Support for the productId property is scheduled to end.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

partner
partner.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/partners/customers

Query Parameters

ParameterTypeDescription
domain string 

Domain name


example : example.com 
count integer 

Number of items to get


default : 10
minimum : 1
maximum : 30 
cursor string 

Cursor value


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 
orderBy string 

Sorting

  • Sort by:
    • Name: name (default)
  • Sort order:
    • asc: Ascending order (default)
    • desc: Descending order Use a blank space (%20) to separate “sort by” and “sort order.”

default : name%20asc
example : name%20desc 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
customers array (Customers) 

List of customers

 
responseMetaData object (responseMetaData) 

Response metadata

 

Customers

PropertyTypeDescription
tenantId integer 

tenant ID


required
readOnly : true 
domainId integer 

Domain ID


required
readOnly : true 
domain string 

Domain name


required 
productId string 

Plan ID

  • FR: Free
  • STD_T: Standard Trial
  • ADV_T: Advanced Trial
  • STD: Standard
  • ADV: Advanced

Caution
Support for productId is scheduled to end.


Allowed values : FR, STD_T, ADV_T, STD, ADV
nullable : true 
companyName string 

Customer company or organization name


required 
phoneNumber string 

Phone number


required 
timeZone string 

Time zone code


required 
locale string 

Language code


required
Allowed values : ja_JP, ko_KR, en_US, zh_TW, zh_CN 
enableActiveMxrecord boolean 

Indicates whether MX records are active.


required 
enableActiveDomain boolean 

Indicates whether the domain is active (or its ownership is verified).


required 
domainType string 

Domain type

  • DOMAIN: Domain
  • GROUP: Group

required
Allowed values : DOMAIN, GROUP 
administrator object (administrator) 

Administrator information

 
partnership object (partnership) 

Domain information

 

administrator

PropertyTypeDescription
lastName string 

Last name


required 
firstName string 

First name

 
id string 

User ID


required 
privateEmail string 

Personal email address


required
format : email 
cellphone string 

Mobile phone number

 
countryCode string 

Country code

 

partnership

PropertyTypeDescription
status string 

Partner status

  • TRANSFER_READY: Waiting for approval after the customer status changes from an online direct customer to the partner’s.
  • TERMS_AGREEMENT_READY: Before the agreement of terms
  • APPROVED: Partnership established

Allowed values : TRANSFER_READY, TERMS_AGREEMENT_READY, APPROVED 
customerCode string 

Customer code (up to 200 bytes)

 
enablePartnerProfileDisplay boolean 

Indicates whether to make the partner profile visible.

 
memo string 

Memo


maxLength : 700 
enableDeveloperConsoleAccessControl boolean 

Indicates whether to enable access to the Developer Console.

 
enableAdminConsoleAccessControl boolean 

Indicates whether to enable access to the Admin Console.

 
useOptionPlus boolean 

Indicates whether to use Option Plus (Obsolete. Always true).

 

responseMetaData

PropertyTypeDescription
nextCursor string 

Cursor value for pagination

 

Response Example

example

1{2  "customers": [3    {4      "tenantId": 10000001,5      "domainId": 10000001,6      "domain": "example.com",7      "productId": "STD_T",8      "companyName": "LINE WORKS Corp.",9      "phoneNumber": "03-0000-0000",10      "timeZone": "Asia/Tokyo",11      "locale": "ja_JP",12      "enableActiveMxrecord": true,13      "enableActiveDomain": true,14      "domainType": "DOMAIN",15      "administrator": {16        "lastName": "Works",17        "firstName": "Administrator",18        "id": "admin",19        "privateEmail": "private.works@example.com",20        "cellphone": "090-0000-0000",21        "countryCode": "+81"22      },23      "partnership": {24        "status": "TRANSFER_READY",25        "customerCode": "asd123ada11",26        "enablePartnerProfileDisplay": true,27        "memo": "memo",28        "enableDevelopersAccess": true,29        "enableAdminAccess": true,30        "useOptionPlus": true31      }32    }33  ],34  "responseMetaData": {35    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="36  }37}

HTTP 400

Bad request