---
title: "Hand over a user to Wayflyer"
url: "https://docs.wayflyer.com/apis/embedded-finance-sandbox-api-1/versions/89e9f620-626b-413f-b4ac-7605711a516f/operations/wf_embedded_finance_service_apps_sandbox_views_handover_handover"
---

> Full API specification: https://docs.wayflyer.com/apis/embedded-finance-sandbox-api-1/versions/89e9f620-626b-413f-b4ac-7605711a516f.md

# Hand over a user to Wayflyer

`POST` `/company/handover/`

Operation ID: `wf_embedded_finance_service_apps_sandbox_views_handover_handover`

Generate a URL to redirect the user to Wayflyer where they can continue their funding application. Requires the company to have an open hosted application.

## Header parameters

- `API-Version` (string, optional)

## Responses

- `200` - OK
- `400` - Bad Request

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Embedded Finance Sandbox
  version: "1"
servers:
  - url: https://sandbox-api.wayflyer.com/financing/
    description: Production
paths:
  /company/handover/:
    post:
      operationId: wf_embedded_finance_service_apps_sandbox_views_handover_handover
      summary: Hand over a user to Wayflyer
      parameters:
        - $ref: "#/components/parameters/ApiVersion"
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HandoverResponse"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HandoverErrorResponse"
      description: >-
        Generate a URL to redirect the user to Wayflyer where they can continue
        their funding application.


        Requires the company to have an open hosted application.
      tags:
        - Handover
      security:
        - CompanyToken: []
security:
  - CompanyToken: []
components:
  parameters:
    ApiVersion:
      in: header
      name: API-Version
      schema:
        title: API-Version
        type: string
        enum:
          - "1"
      required: false
  schemas:
    HandoverResponse:
      properties:
        url:
          title: Url
          type: string
      required:
        - url
      title: HandoverResponse
      type: object
    HandoverErrorResponse:
      properties:
        error_code:
          $ref: "#/components/schemas/HandoverErrorCode"
          description: Machine-readable error code
        detail:
          description: Human-readable error message
          title: Detail
          type: string
      required:
        - error_code
        - detail
      title: HandoverErrorResponse
      type: object
    HandoverErrorCode:
      enum:
        - company_not_bootstrapped
        - no_open_hosted_application
        - company_not_active
      title: HandoverErrorCode
      type: string
  securitySchemes:
    CompanyToken:
      type: http
      scheme: bearer
```