# Retrieve the page by live URL

Resolves a public live URL to its corresponding page in Sitecore. Use this endpoint when you know the URL of a published page and need to identify the page behind it.

Endpoint: GET /api/v1/pages/path-by-url
Version: v2.0
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

## Query parameters:

  - `live_url` (string, required)
    The full public URL of the page to resolve. The URL must be absolute and include the page path.

  - `deep` (boolean)
    Whether to search the site's published routes when the standard lookup cannot find the page. Set to `true` when a page you know exists is returned as not found, for example when its public URL differs from its item name in Sitecore. This lookup can take significantly longer.

## Header parameters:

  - `x-sc-job-id` (any)
    A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.

## Response 200:

  - `200` (unknown)
    Successful response

## Response 200 fields (application/json):

  - `itemId` (string)
    The unique identifier of the page.
    Example: 3f2504e0-4f89-11d3-9a0c-0305e82c3301

  - `name` (string)
    The name of the page.
    Example: Home

  - `hasPresentation` (boolean)
    Whether the page has presentation details.
    Example: true

  - `template` (object)

  - `template.templateId` (string)
    The unique identifier of the template.
    Example: 3f2504e0-4f89-11d3-9a0c-0305e82c3301

  - `template.name` (string)
    The name of the template.
    Example: Full Width Page

  - `insertOptions` (array)
    Insert options for the page.

  - `insertOptions.name` (string)
    The name of the insert option.
    Example: Full Width Page

  - `insertOptions.templateId` (string)
    The unique identifier of the template.
    Example: 3f2504e0-4f89-11d3-9a0c-0305e82c3301

  - `language` (string)
    The language in which the page was resolved. For locale-prefixed URLs, such as /fr/..., this reflects the language identified from the URL. Use the returned language value in subsequent requests to read or update the page’s field values for the correct language version; otherwise, the request may default to English.
    Example: en

## Response 422:

  - `422` (unknown)
    Unprocessable entity

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array)
    The location of the error in the request.

  - `detail.msg` (string)
    The error message.

  - `detail.type` (string)
    The type of error.

  - `detail.input` (any)
    The input that caused the error.

  - `detail.ctx` (object)
    The context in which the error occurred.