페이지 이동경로
  • Docs>
  • Kakao Moment>
  • Ad account management

Kakao Moment

Ad account management

This document describes how to use the Ad account management API.

View business information

This API enables you to retrieve business information.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. You must also pass the business registration number of a company to be retrieved. If the request is successful, this API returns the detailed information of the requested company in JSON format. If failed, refer to Error code to figure out its failure cause.

Request

URL
GET /openapi/v4/companies HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
bizNum String Business registration number. O

Response

Name Type Description
id Long Company's ID.
businessRegistrationNumber String Business registration number.
name String Company's name.
representationName String Company's representative.
address Address Company's address.
businessCategory String Type of business.
businessItem String Item of business.
Address
Name Type Description
baseAddress String Base address.
detailAddress String Detailed address.
zipCode String Zip code.

Sample

Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/companies?bizNum=120-81-47521" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
{
    "id": 680,
    "businessRegistrationNumber": "123-12-12345",
    "name": "company name",
    "representationName": "company representative name",
    "businessCategory": "business type",
    "businessItem": "business item",
    "address": {
        "zipCode": "13494",
        "baseAddress": "경기 성남시 분당구 판교역로 235",
        "detailAddress": "H스퀘어"
    }
}

See more

Kakao Moment> Ad account management