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

# Post apiusersearch history retry



## OpenAPI

````yaml /api-reference/openapi.json post /api/user/search-history/{search_id}/retry/
openapi: 3.0.3
info:
  title: SphereScout API
  version: 1.0.0
  description: >

    # SphereScout API


    SphereScout provides B2B lead data — business contacts with emails,

    phone numbers, and location metadata — across multiple countries.


    ## Authentication


    All endpoints (except `/api/auth/` and `/api/plans`) require a **JWT Bearer
    token**.


    1. **Register** — `POST /api/auth/sign-up/`

    2. **Login** — `POST /api/auth/login/` → returns `access` and `refresh`
    tokens

    3. **Attach header** — `Authorization: Bearer <access_token>`

    4. **Refresh** — `POST /api/token/refresh/` with `{ "refresh": "<token>" }`


    Access tokens expire after 60 minutes. Refresh tokens are long-lived.


    ## Credits


    Every account has a credit balance. Exporting leads costs **1 credit per
    lead**.

    Check your balance via `GET /api/user/profile/`. Credits reset each billing
    cycle

    for subscribed users.


    ## Async Download Workflow


    Exporting leads is asynchronous:


    1. **Search** — `GET /api/companies/` to preview results and get
    `totalCount`

    2. **Export** — `POST /api/download-csv/` to start generation (credits
    deducted immediately)

    3. **Poll** — `GET /api/download-status/{search_id}/` until `status =
    COMPLETED`

    4. **Download** — `GET /api/download-completed-csv/{search_id}/` to get a
    signed URL


    ## API Keys (recommended for integrations)


    Generate a persistent API key from your dashboard under **API Keys**.


    Attach it to every request:

    ```
      Authorization: Token <your-api-key>
    ```


    Keys can be given an expiry date and revoked at any time.

    JWT Bearer tokens (`Authorization: Bearer <jwt>`) continue to work for
    browser sessions and Swagger UI testing.


    ## Rate Limiting


    API requests are rate-limited. If you receive a `429` response, back off and
    retry.


    ## Versioning


    This is **v1** of the API. Breaking changes will be communicated in advance.
servers:
  - url: https://www.spherescout.io
security: []
tags:
  - name: Authentication
    description: Register, login, refresh tokens, and reset passwords.
  - name: Search
    description: Search and preview business leads by country, category, and location.
  - name: Download
    description: 'Export leads to CSV/Excel. Async workflow: initiate → poll → download.'
  - name: History
    description: View past searches and their download status.
  - name: Credits & Profile
    description: Check credit balance, subscription plan, and user profile.
  - name: Geography
    description: Countries, states/regions, counties, and cities for search filters.
  - name: API Keys
    description: Create, list, and revoke persistent API keys for integrations.
paths:
  /api/user/search-history/{search_id}/retry/:
    post:
      tags:
        - user
      operationId: user_search_history_retry_create
      parameters:
        - in: path
          name: search_id
          schema:
            type: integer
          required: true
      responses:
        '200':
          description: No response body
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: cURL
          source: >-
            curl -X POST
            'https://www.spherescout.io/api/user/search-history/{search_id}/retry/'
            \
              -H 'Authorization: Token YOUR_API_KEY' \
              -H 'User-Agent: SphereScout/1.0' \
              -H 'Content-Type: application/json' \
              -d '{}'
        - lang: Python
          source: |-
            import requests

            response = requests.post(
                "https://www.spherescout.io/api/user/search-history/{search_id}/retry/",
                headers={
                    "Authorization": "Token YOUR_API_KEY",
                    "User-Agent": "SphereScout/1.0",
                },
                json={},
            )
            print(response.json())
        - lang: JavaScript
          source: >-
            const response = await
            fetch("https://www.spherescout.io/api/user/search-history/{search_id}/retry/",
            {
              method: "POST",
              headers: {
                "Authorization": "Token YOUR_API_KEY",
                "User-Agent": "SphereScout/1.0",
                "Content-Type": "application/json",
              },
              body: JSON.stringify({}),
            });

            const data = await response.json();
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key. Format: Token <your-api-key>'

````