Kurly

aid: kurly
name: Kurly
description: 'Kurly (컬리, operated by The Farmers Front) is a South Korean online grocery and lifestyle commerce company, known
  for Market Kurly and its overnight "dawn delivery" (샛별배송) model built on a cold-chain fulfillment network. Kurly Logistics
  Services (KLS) opens that network to contracted shipper clients (화주사) as a B2B Open API spanning three service families:
  fulfillment (물류대행), where Kurly holds and ships the shipper''s stock, covering goods master, inbound receiving, inventory
  and ledgers, outbound orders and fulfillment plans; delivery agency (배송대행), where the shipper ships from their own warehouse
  over Kurly''s Nextmile last-mile network; and shared delivery tracking. Access is contract-gated — clientId and secretKey
  are issued only after IP allowlist registration — and Kurly states as policy that KLS does not push data to external systems,
  so integrations poll rather than subscribe to webhooks.'
url: https://raw.githubusercontent.com/api-evangelist/kurly/refs/heads/main/apis.yml
image: https://res.kurly.com/icons/favicon-192x192.png
x-type: company
x-source: vc-portfolio
x-backed-by:
- hongshan
x-tier: profiled
x-tier-reason: live-api-enriched
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-19'
tags:
- Company
- Technology
- Logistics
- Fulfillment
- Supply Chain
- Delivery
- Ecommerce
- Grocery
- Shipping
- Order Management
- Inventory
- Tracking
- South Korea
apis:
- name: Kurly Logistics Services (KLS) Fulfillment API
  description: Fulfillment (물류대행) operations for shippers whose stock Kurly holds — goods master and sales-channel mapping,
    inbound receiving requests with labels and specifications, inventory and per-SKU/per-lot ledgers, and outbound order registration,
    cancellation and fulfillment plans. 24 operations.
  humanURL: https://developers.kurly.com/docs/api/물류대행
  baseURL: https://kls.kurly.com
  image: https://res.kurly.com/icons/favicon-192x192.png
  tags:
  - Fulfillment
  - Inventory
  - Order Management
  - Logistics
  properties:
  - type: OpenAPI
    url: openapi/kurly-kls-fulfillment-openapi.yml
  - type: Overlay
    url: overlays/kurly-fulfillment-overlay.yaml
  - type: Documentation
    url: https://developers.kurly.com/docs/api/물류대행
  - type: GettingStarted
    url: https://developers.kurly.com/docs/guide/물류대행/inbound/입고-정책-가이드
- name: Kurly Logistics Services (KLS) Delivery Agency API
  description: Delivery agency (배송대행) operations for shippers who ship from their own warehouse over Kurly's Nextmile network
    — order registration with a requestKey idempotency key, lookup and cancellation by request key or sales-channel order
    number, delivery-service policy lookup, and bulk waybill print data. 7 operations.
  humanURL: https://developers.kurly.com/docs/api/배송대행
  baseURL: https://kls.kurly.com
  image: https://res.kurly.com/icons/favicon-192x192.png
  tags:
  - Delivery
  - Shipping
  - Order Management
  properties:
  - type: OpenAPI
    url: openapi/kurly-kls-delivery-agency-openapi.yml
  - type: Overlay
    url: overlays/kurly-delivery-agency-overlay.yaml
  - type: Documentation
    url: https://developers.kurly.com/docs/api/배송대행
  - type: GettingStarted
    url: https://developers.kurly.com/docs/guide/배송대행/배송대행-연동-가이드
- name: Kurly Logistics Services (KLS) Delivery Tracking API
  description: Shared delivery tracking (배송추적) — returns the processing state and accumulated tracking events for a waybill
    delivered by Kurly Nextmile, usable by both fulfillment and delivery-agency shippers. Nine documented tracking states,
    of which delivered and failed are terminal.
  humanURL: https://developers.kurly.com/docs/api/배송추적
  baseURL: https://kls.kurly.com
  image: https://res.kurly.com/icons/favicon-192x192.png
  tags:
  - Tracking
  - Delivery
  properties:
  - type: OpenAPI
    url: openapi/kurly-kls-delivery-tracking-openapi.yml
  - type: Overlay
    url: overlays/kurly-delivery-tracking-overlay.yaml
  - type: Documentation
    url: https://developers.kurly.com/docs/api/배송추적
  - type: GettingStarted
    url: https://developers.kurly.com/docs/guide/배송추적/배송-추적-API-연동-가이드
- name: Kurly Logistics Services (KLS) Authentication API
  description: Exchanges the clientId and secretKey Kurly issues after IP allowlist registration for a Bearer access token
    used across every other KLS API.
  humanURL: https://developers.kurly.com/docs/api/인증/토큰-발급
  baseURL: https://kls.kurly.com
  image: https://res.kurly.com/icons/favicon-192x192.png
  tags:
  - Authentication
  - Security
  properties:
  - type: OpenAPI
    url: openapi/kurly-kls-auth-openapi.yml
  - type: Overlay
    url: overlays/kurly-auth-overlay.yaml
  - type: Authentication
    url: https://developers.kurly.com/docs/auth
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://kurly.com
- type: DeveloperPortal
  url: https://developers.kurly.com/
- type: Documentation
  url: https://developers.kurly.com/docs/intro
- type: APIReference
  url: https://developers.kurly.com/docs/api
- type: GettingStarted
  url: https://developers.kurly.com/docs/intro
- type: Support
  url: https://developers.kurly.com/docs/faq
- type: Blog
  url: https://helloworld.kurly.com/
- type: GitHubOrganization
  url: https://github.com/thefarmersfront
- type: SignUp
  name: KLS API access request (IP allowlist registration)
  url: https://developers.kurly.com/docs/auth
- type: Console
  name: KLS shipper console
  url: https://kls.kurly.com/
- type: Authentication
  url: authentication/kurly-authentication.yml
- type: AgenticAccess
  url: agentic-access/kurly-agentic-access.yml
- type: MCPServer
  name: Candidate MCP tool surface (derived, not published by Kurly)
  url: mcp/kurly-mcp.yml
- type: LLMsTxt
  url: llms/kurly-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: Conventions
  url: conventions/kurly-conventions.yml
- type: Idempotency
  name: requestKey and X-Idempotency-Key idempotency contract
  url: conventions/kurly-conventions.yml
- type: ErrorCatalog
  url: errors/kurly-error-codes.yml
- type: DataModel
  url: data-model/kurly-data-model.yml
- type: Vocabulary
  url: vocabulary/kurly-vocabulary.yml
- type: RateLimits
  url: rate-limits/kurly-rate-limits.yml
- type: Lifecycle
  url: lifecycle/kurly-lifecycle.yml
- type: ChangeLog
  url: changelog/kurly-changelog.yml
- type: ChangeLog
  name: KLS published changelog
  url: https://developers.kurly.com/changelog
- type: Conformance
  url: conformance/kurly-conformance.yml
- type: Sandbox
  name: KLS test environment (security-gated, not self-service)
  url: sandbox/kurly-sandbox.yml
- type: DomainSecurity
  url: security/kurly-domain-security.yml
- type: WellKnown
  name: Well-known probe results (no documents published)
  url: well-known/kurly-well-known.yml
- type: Arazzo
  name: Register a delivery-agency order idempotently and follow it to delivery
  url: arazzo/kurly-delivery-order-to-tracking.yml
- type: Arazzo
  name: Book goods inbound to a Kurly centre and monitor receiving to completion
  url: arazzo/kurly-inbound-receiving-flow.yml
- type: Arazzo
  name: Map a product, check stock, order fulfillment in bulk, and read the plan back
  url: arazzo/kurly-fulfillment-order-flow.yml
x-enrichment:
  date: '2026-07-19'
  status: backfilled
  pass: local-v1
  note: backfilled from .gitignore signal + verified work evidence