Alamat

Daftar Alamat

Daftar alamat pengirim tersimpan milik akun.

GET /courier/v1/addresses

Contoh Request

cURL

curl -X GET 'https://use.api.co.id/courier/v1/addresses' \
  -H 'x-api-co-id: YOUR_API_KEY'

JavaScript

const res = await fetch('https://use.api.co.id/courier/v1/addresses', {
  method: 'GET',
  headers: {
    'x-api-co-id': 'YOUR_API_KEY',
  },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://use.api.co.id/courier/v1/addresses",
    headers={"x-api-co-id": "YOUR_API_KEY"},
)
data = res.json()

Contoh Response

{
  "is_success": true,
  "message": "OK",
  "data": [
    {
      "id": "adr_7b1c",
      "label": "Gudang Utama",
      "contact_name": "Budi",
      "contact_phone": "0899...",
      "province_code": "33",
      "city_code": "3374",
      "district_code": "3374010",
      "address_line": "Jl. Pemuda No. 1",
      "postal_code": "50139",
      "is_default": true
    }
  ]
}

Buat Alamat

Menyimpan alamat pengirim baru. Alamat dapat dipakai sebagai sender_address_id pada Cek Ongkir & order.

POST /courier/v1/addresses

Body

Parameter	Tipe	Wajib	Keterangan
label	string	ya	Nama alamat, mis. "Gudang Utama".
contact_name	string	ya	Nama kontak pengirim.
contact_phone	string	ya	Nomor telepon pengirim.
province_code	string	ya	Kode provinsi.
city_code	string	ya	Kode kota/kabupaten.
district_code	string	ya	Kode kecamatan (harus terlayani kurir).
address_line	string	ya	Alamat lengkap.
postal_code	string	tidak	Kode pos.
is_default	boolean	tidak	Jadikan alamat default.

Contoh Request

cURL

curl -X POST 'https://use.api.co.id/courier/v1/addresses' \
  -H 'x-api-co-id: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "label": "Gudang Utama",
    "contact_name": "Budi",
    "contact_phone": "08990000000",
    "province_code": "33",
    "city_code": "3374",
    "district_code": "3374010",
    "address_line": "Jl. Pemuda No. 1",
    "postal_code": "50139",
    "is_default": true
}'

JavaScript

const res = await fetch('https://use.api.co.id/courier/v1/addresses', {
  method: 'POST',
  headers: {
    'x-api-co-id': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "label": "Gudang Utama",
    "contact_name": "Budi",
    "contact_phone": "08990000000",
    "province_code": "33",
    "city_code": "3374",
    "district_code": "3374010",
    "address_line": "Jl. Pemuda No. 1",
    "postal_code": "50139",
    "is_default": true
}),
});
const data = await res.json();

Python

import requests

res = requests.post(
    "https://use.api.co.id/courier/v1/addresses",
    json={"label":"Gudang Utama","contact_name":"Budi","contact_phone":"08990000000","province_code":"33","city_code":"3374","district_code":"3374010","address_line":"Jl. Pemuda No. 1","postal_code":"50139","is_default":true},
    headers={"x-api-co-id": "YOUR_API_KEY"},
)
data = res.json()

Contoh Response

{
  "is_success": true,
  "message": "Alamat berhasil dibuat.",
  "data": { "id": "adr_7b1c" }
}

Coba langsung

tip

Pakai Test Key sandbox untuk mencoba endpoint ini tanpa membuat pengiriman atau biaya sungguhan. Lihat Sandbox.

• GET/courier/v1/addressesList Addresses
• POST/courier/v1/addressesCreate Address