All APIs are operational.


About Getting Started

  • When the official lostark website goes down for maintenance, so does Lostark Open API website, including all API endpoints as well. Also please note that Lostark Open API services alone could be under maintenance whenever unfortunate, unexpected errors occur.

  • Make sure you set a valid Access Token ( JWT ) value in the Authorize popup input.
    ex) bearer your_JWT

    ※ Even if the token is correct, token validation will fail if the leading 'bearer' string is missing.
    ※ Make sure you avoided bad examples below.
    Example Validity
    "Authorization: bearer abcdefghijklmnopqrstuvwxyz" O => VALID
    "Authorization: abcdefghijklmnopqrstuvwxyz" X => INVALID (missing "bearer")
    "Authorization: bearer {abcdefghijklmnopqrstuvwxyz}" X => INVALID
    "Authorization: bearer <abcdefghijklmnopqrstuvwxyz>" X => INVALID
    "Authorization: bearer{abcdefghijklmnopqrstuvwxyz}" X => INVALID
    "Authorization: bearerabcdefghijklmnopqrstuvwxyz" X => INVALID
  • Yes you can. URL is not required.

  • Up to 5 per an account

  • No you can't. You must agree to the Terms of Use and the Privacy Policy.

  • Look for API KEY. You can find the key on your MY CLIENTS page or you can check the token on the popup by clicking the red identity button above on the right top corner.

  • To support developers better. Throttling can ensure fair usage, service stability, and good application design. You will get to come up with a better caching strategy to fetch in-game data on your client application because the number of requests is limited to a certain amount.

  • "Try it out" will only populate input fields and the "Execute" button. You need to fill in those required parameters and click Execute button to make an actual HTTP call.

About Usage

  • It may take up a few minutes to sync up. Let us know if you still can't retrieve the latest, updated data after a half an hour.

  • Please email us and describe what you encountered as detailed as possible. Presenting a way to reproduce will be greatly appreciated.

  • Please check out
    1. your JWT token.
    2. the authorization header and bearer input
    3. the http status code you receive.
    4. API Status on our website.
    5. the response header and the throttling details

  • You may need to check out the API request limit and the http response headers. If you see 0 value for 'X-RateLimit-Remaining' key, you may throttle your client application or adjust the request interval.

  • Only application/json is allowed.

Still have a question?