> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve current redirects

export const ScopesList = ({scopes = [], description = "Diese API erfordert einen der folgenden Bereiche:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => {
  const translations = {
    header: "Unterstützte Produkte",
    description: "Erfordert eines der folgenden Produkte oder höher.",
    productNames: {
      marketing: "Marketing Hub",
      sales: "Sales Hub",
      service: "Service Hub",
      cms: "Content Hub"
    },
    tiers: {
      free: "Kostenlos",
      starter: "Starter",
      professional: "Professional",
      enterprise: "Enterprise"
    }
  };
  const translateTier = tier => {
    if (!tier) return '';
    const lowerTier = tier.toLowerCase();
    return translations.tiers[lowerTier] || tier;
  };
  const products = [{
    name: marketing ? translations.productNames.marketing : '',
    level: translateTier(marketingLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg",
    alt: "Marketing Hub"
  }, {
    name: sales ? translations.productNames.sales : '',
    level: translateTier(salesLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg",
    alt: "Sales Hub"
  }, {
    name: service ? translations.productNames.service : '',
    level: translateTier(serviceLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg",
    alt: "Service Hub"
  }, {
    name: cms ? translations.productNames.cms : '',
    level: translateTier(cmsLevel),
    icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg",
    alt: "Content Hub"
  }].filter(product => product.name && product.level);
  if (products.length === 0) return null;
  return <div>
      <div className="text-sm mb-2">{translations.description}</div>
      <div className={`grid ${products.length === 1 ? 'grid-cols-1' : 'grid-cols-2'} gap-1.5`}>
        {products.map((product, index) => <div key={index} style={{
    display: 'flex',
    alignItems: 'center'
  }}>
            <img src={product.icon} alt={product.alt} className="w-3.5 h-3.5 mr-1.5 mt-2.5 mb-2.5 flex-shrink-0 align-middle" />
            <span className="font-medium mr-1 text-sm">{product.name} -</span>
            <span className="text-sm">{product.level}</span>
          </div>)}
      </div>
    </div>;
};

<AccordionGroup>
  <Accordion title="Supported products" defaultOpen="true" icon="cubes">
    <SupportedProducts marketing={true} sales={true} service={true} cms={true} marketingLevel="PROFESSIONAL" salesLevel="FREE" serviceLevel="FREE" cmsLevel="STARTER" />
  </Accordion>

  <Accordion title="Required Scopes" icon="key">
    <ScopesList
      scopes={[
  'content'
]}
    />
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml specs/2026-03/cms-url-redirects-v2026-03.json GET /cms/url-redirects/2026-03
openapi: 3.0.1
info:
  title: URL-Weiterleitungen
  description: Basepom for all HubSpot Projects
  version: 2026-03
  x-hubspot-product-tier-requirements:
    marketing: PROFESSIONAL
    sales: FREE
    service: FREE
    cms: STARTER
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
  x-hubspot-api-use-case: >-
    Leiten Sie eine Seite zu einer anderen weiter, oder leiten Sie einen ganzen
    Blog mit einer URL weiter, indem Sie flexible Mustervariablen verwenden.
  x-hubspot-introduction: >-
    Verwenden Sie die URL-Weiterleitungs-API, um den Traffic von einer auf
    HubSpot gehosteten Seite oder einem Blogbeitrag zu einer beliebigen URL
    weiterzuleiten. Sie können Seiten zu bestimmten URLs weiterleiten oder
    flexible Musterweiterleitungen verwenden, um mehrere Seiten mithilfe von
    Variablen weiterzuleiten. Erfahren Sie mehr über die Verwaltung von
    Weiterleitungen in HubSpot.
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
paths:
  /cms/url-redirects/2026-03:
    get:
      tags:
        - Basic
      operationId: get-/cms/url-redirects/2026-03_/cms/url-redirects/v3
      parameters:
        - name: after
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
        - name: archived
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: boolean
        - name: createdAfter
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: createdAt
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: createdBefore
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: limit
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: integer
            format: int32
        - name: sort
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: updatedAfter
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: updatedAt
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
        - name: updatedBefore
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CollectionResponseWithTotalUrlMappingForwardPaging
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - content
components:
  schemas:
    CollectionResponseWithTotalUrlMappingForwardPaging:
      required:
        - results
        - total
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/ForwardPaging'
        results:
          type: array
          description: >-
            Ein Array von UrlMapping-Objekten, die jeweils eine spezifische
            URL-Zuordnung darstellen.
          items:
            $ref: '#/components/schemas/UrlMapping'
        total:
          type: integer
          description: Die Gesamtanzahl der verfügbaren URL-Zuordnungen.
          format: int32
    ForwardPaging:
      type: object
      properties:
        next:
          $ref: '#/components/schemas/NextPage'
    UrlMapping:
      required:
        - created
        - destination
        - id
        - isMatchFullUrl
        - isMatchQueryString
        - isOnlyAfterNotFound
        - isPattern
        - isProtocolAgnostic
        - isTrailingSlashOptional
        - precedence
        - redirectStyle
        - routePrefix
        - updated
      type: object
      properties:
        created:
          type: string
          description: >-
            Der Zeitpunkt (Datum und Uhrzeit), zu dem die URL-Zuordnung
            ursprünglich erstellt wurde.
          format: date-time
        destination:
          type: string
          description: >-
            Die Ziel-URL, an die die Target-URL bei einer Übereinstimmung mit
            „routePrefix“ weitergeleitet wird.
        id:
          type: string
          description: Die eindeutige ID dieser URL-Weiterleitung.
        isMatchFullUrl:
          type: boolean
          description: >-
            Ob „routePrefix“ mit der gesamten URL übereinstimmen soll,
            einschließlich Domain.
        isMatchQueryString:
          type: boolean
          description: >-
            Ob „routePrefix“ mit der gesamten URL übereinstimmen soll,
            einschließlich Abfragezeichenfolge.
        isOnlyAfterNotFound:
          type: boolean
          description: >-
            Ob die URL-Weiterleitungszuordnung nur angewendet werden soll, wenn
            keine live geschaltete Seite unter der URL gefunden wird. Bei
            „false“ (falsch) hat die URL-Weiterleitungszuordnung Vorrang vor
            anderen vorhandenen Seiten.
        isPattern:
          type: boolean
          description: Ob „routePrefix“ mit dem Muster übereinstimmen soll.
        isProtocolAgnostic:
          type: boolean
          description: >-
            Ob „routePrefix“ mit dem HTTP- und dem HTTPS-Protokoll
            übereinstimmen soll.
        isTrailingSlashOptional:
          type: boolean
          description: Ob ein angehängter Schrägstrich ignoriert werden soll.
        precedence:
          type: integer
          description: >-
            Wird verwendet, um die URL-Weiterleitung zu priorisieren. Wenn eine
            angegebene URL mit mehr als einer Weiterleitung übereinstimmt, wird
            diejenige mit der **niedrigeren** Priorität verwendet.
          format: int32
        redirectStyle:
          type: integer
          description: >-
            Der Typ der zu erstellenden Weiterleitung. Mögliche Optionen: 301
            (dauerhaft), 302 (temporär) oder 305 (Proxy). Weitere Informationen
            finden Sie
            [hier].(https://knowledge.hubspot.com/cos-general/how-to-redirect-a-hubspot-page).
          format: int32
        routePrefix:
          type: string
          description: >-
            Die eingehende Ziel-URL, der Pfad oder das Muster für die
            Weiterleitung.
        updated:
          type: string
          description: >-
            Der Zeitpunkt (Datum und Uhrzeit), zu dem die URL-Zuordnung zuletzt
            geändert wurde.
          format: date-time
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: Die Fehlerkategorie
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Kontext zur Fehlerbedingung
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Eine eindeutige ID für die Anfrage. Berücksichtigen Sie diesen Wert
            in Fehlerberichten oder Support-Tickets.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: Weitere Informationen zum Fehler
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Eine Zuordnung der Namen von Links zu zugeordneten URIs mit einer
            Dokumentation zum Fehler oder empfohlenen Abhilfemaßnahmen
        message:
          type: string
          description: >-
            Eine für Menschen lesbare Nachricht mit einer Beschreibung des
            Fehlers und ggf. Abhilfemaßnahmen
          example: An error occurred
        subCategory:
          type: string
          description: Eine spezifische Kategorie, die genauere Details zum Fehler enthält
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    NextPage:
      required:
        - after
      type: object
      properties:
        after:
          type: string
          description: >-
            Der Cursorwert, der angibt, wo mit dem Abrufen der nächsten
            Ergebnisseite in einer paginierten Sammlung begonnen werden soll.
        link:
          type: string
          description: >-
            Eine optionale URL für den direkten Zugriff auf die nächste
            Ergebnisseite.
      description: >-
        Specifies the paging information needed to retrieve the next set of
        results in a paginated API response
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: Der Statuscode, der dem Fehlerdetail zugeordnet ist
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Kontext zur Fehlerbedingung
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: >-
            Der Name des Felds oder Parameters, in dem der Fehler gefunden
            wurde.
        message:
          type: string
          description: >-
            Eine für Menschen lesbare Nachricht mit einer Beschreibung des
            Fehlers und ggf. Abhilfemaßnahmen
        subCategory:
          type: string
          description: Eine spezifische Kategorie, die genauere Details zum Fehler enthält
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            cms-url-redirects-delete: ''
            content: ''

````