---
title: "Get Faceswap Result List"
method: GET
path: "/api/open/v3/faceswap/result/listbyids"
tags: ["Face Swap"]
---

# Get Faceswap Result List

`GET /api/open/v3/faceswap/result/listbyids`

Get faceswap results by IDs

## Query parameters

- `_ids` string, required

## Response `200`

List of faceswap results

- object
  - `code` integer, required — Interface returns business status code (1000: success)
  - `msg` string, required — Interface returns status information
  - `data` FaceswapResultList
    - `result` FaceswapResultDetail[]
      - `faceswap_type` integer — Faceswap type
      - `faceswap_quality` integer — Faceswap quality level
      - `faceswap_status` 1 | 2 | 3 | 4 — Faceswap result status: 1 In Queue, 2 Processing, 3 Success, 4 Failed
      - `deduction_status` integer — Deduction status
      - `image` integer — Image indicator
      - `video_duration` number — Video duration in seconds
      - `deduction_duration` number — Deduction duration
      - `update_time` number — Update timestamp
      - `_id` string — Result ID
      - `userId` string — User ID
      - `uid` integer — User unique ID
      - `url` string — Faceswap result URL
      - `createdAt` string, date-time — Current faceswap action created time

---

[API](https://skmtc.dev/akool/apis/face-detection-api.md) · [All operations](https://skmtc.dev/akool/apis/face-detection-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akool/face-detection-api/revisions/ce2ff5679949/schema)