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

# Get Faceswap Result List

> Get faceswap results by IDs

## Important Notes

* Result IDs should be comma-separated strings
* You can get the `_id` field from [Image Faceswap](/ai-tools-suite/faceswap/image-faceswap) or [Video Faceswap](/ai-tools-suite/faceswap/video-faceswap) API responses

## Faceswap Status

| Status | Description |
| ------ | ----------- |
| 1      | In Queue    |
| 2      | Processing  |
| 3      | Success     |
| 4      | Failed      |


## OpenAPI

````yaml GET /api/open/v3/faceswap/result/listbyids
openapi: 3.0.3
info:
  title: Face Swap API
  description: API for face swapping in images and videos
  version: 1.0.0
servers:
  - url: https://openapi.akool.com
    description: Production server
security:
  - ApiKeyAuth: []
  - BearerAuth: []
paths:
  /api/open/v3/faceswap/result/listbyids:
    get:
      tags:
        - Face Swap
      summary: Get Faceswap Result List
      description: Get faceswap results by IDs
      parameters:
        - name: _ids
          in: query
          required: true
          schema:
            type: string
          description: Result IDs are strings separated by commas
      responses:
        '200':
          description: List of faceswap results
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/FaceswapResultList'
components:
  schemas:
    ApiResponse:
      type: object
      required:
        - code
        - msg
      properties:
        code:
          type: integer
          description: 'Interface returns business status code (1000: success)'
          example: 1000
        msg:
          type: string
          description: Interface returns status information
          example: OK
    FaceswapResultList:
      type: object
      properties:
        result:
          type: array
          items:
            $ref: '#/components/schemas/FaceswapResultDetail'
    FaceswapResultDetail:
      type: object
      properties:
        faceswap_type:
          type: integer
          description: Faceswap type
        faceswap_quality:
          type: integer
          description: Faceswap quality level
        faceswap_status:
          type: integer
          enum:
            - 1
            - 2
            - 3
            - 4
          description: >-
            Faceswap result status: 1 In Queue, 2 Processing, 3 Success, 4
            Failed
        deduction_status:
          type: integer
          description: Deduction status
        image:
          type: integer
          description: Image indicator
        video_duration:
          type: number
          description: Video duration in seconds
        deduction_duration:
          type: number
          description: Deduction duration
        update_time:
          type: number
          description: Update timestamp
        _id:
          type: string
          description: Result ID
        userId:
          type: string
          description: User ID
        uid:
          type: integer
          description: User unique ID
        url:
          type: string
          description: Faceswap result URL
        createdAt:
          type: string
          format: date-time
          description: Current faceswap action created time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your API Key used for request authorization. If both Authorization and
        x-api-key have values, Authorization will be used first and x-api-key
        will be discarded.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your API Key used for request authorization. Get Token from
        authentication/usage#get-the-token

````