---
title: "Get URL‑endpoint"
method: GET
path: "/v1/accounts/url-endpoints/{id}"
tags: ["Account Management API", "URL endpoints"]
---

# Get URL‑endpoint

`GET /v1/accounts/url-endpoints/{id}`

**Note:** This API is currently in beta.  
Retrieves the URL‑endpoint identified by `id`.

## Path parameters

- `id` string, required — Unique identifier for the URL-endpoint. This is generated by ImageKit when you create a new URL-endpoint. For the default URL-endpoint, this is always `default`.

## Response `200`

Successful response.

- UrlEndpointResponse — URL‑endpoint object as returned by the API.
  - `description` string, required — Description of the URL endpoint.
  - `urlPrefix` string, required — Path segment appended to your base URL to form the endpoint (letters, digits, and hyphens only — or empty for the default endpoint).
  - `origins` string[], required — Ordered list of origin IDs to try when the file isn’t in the Media Library; ImageKit checks them in the sequence provided. Origin must be created before it can be used in a URL endpoint.
  - `urlRewriter` union — Configuration for third-party URL rewriting.
    - object
      - `type` 'CLOUDINARY', required
      - `preserveAssetDeliveryTypes` boolean, required — Whether to preserve `<asset_type>/<delivery_type>` in the rewritten URL.
    - object
      - `type` 'IMGIX', required
    - object
      - `type` 'AKAMAI', required
  - `id` string, required — Unique identifier for the URL-endpoint. This is generated by ImageKit when you create a new URL-endpoint. For the default URL-endpoint, this is always `default`.

## Other responses

- `401` — Unauthorized request.
- `403` — Forbidden.
- `404` — Resource not found
- `429` — The request exceeded the rate limit. Contains headers indicating the limits and a message detailing the error.

---

[API](https://skmtc.dev/imagekit-developer/apis/imagekit-api.md) · [All operations](https://skmtc.dev/imagekit-developer/apis/imagekit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imagekit-developer/imagekit-api/revisions/bb3e9ff84b3e/schema)