Export jobs

GET `/export-jobs`

List the organization's CSV export jobs, newest first. A completed job carries a signed fileUrl to download.

Requires the exports:read permission.

Query parameters

limitnumber

The number of records to return.

cursorstring

A pagination cursor. Fetch the next page by passing the nextCursor value from the previous response.

sortcreatedAt | -createdAt

The sort order. Prefix a field with - to sort descending. Defaults to -createdAt.

filterstring

A JSON-encoded filter document, for example {"createdAt":{"$gte":"2025-01-01T00:00:00Z"}}. Filterable fields: id, type, status, createdAt. See Filtering for the syntax.

Request

curl \
  "https://your-store.meisei.app/api/export-jobs" \
  -H "Authorization: Bearer sk_YOUR_SECRET_KEY"

Request

import { client } from "@meisei/api/admin/client"
import { getExportJobs } from "@meisei/api/admin"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
  headers: { Authorization: "Bearer sk_YOUR_SECRET_KEY" },
})

const { data, error } = await getExportJobs()

Request

require "meisei"

meisei = Meisei::Client.new(
  secret_key: "sk_YOUR_SECRET_KEY",
  base_url: "https://your-store.meisei.app/api",
)

page = meisei.export_jobs.list

Request

from meisei import Client

meisei = Client(
    secret_key="sk_YOUR_SECRET_KEY",
    base_url="https://your-store.meisei.app/api",
)

page = meisei.export_jobs.list()

Response

{
  "data": [
    {
      "id": "A4Ws1igz",
      "userId": "uHKNC81a",
      "fileUrl": "string",
      "type": "customers",
      "status": "pending",
      "totalCount": 0,
      "filter": "...",
      "search": "string",
      "createdAt": "2025-01-15T09:30:00Z",
      "updatedAt": "2025-01-15T09:30:00Z"
    }
  ],
  "nextCursor": "string"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the export job.",
            "idCodec": "sqid"
          },
          "userId": {
            "type": "string",
            "description": "The ID of the user who started the export.",
            "idCodec": "controlPlane"
          },
          "fileUrl": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "A signed URL to download the finished CSV. Null until the export completes."
          },
          "type": {
            "type": "string",
            "enum": [
              "customers",
              "products",
              "orders",
              "surveys",
              "reviews",
              "wishlists",
              "loyalty-activity",
              "loyalty-members"
            ],
            "description": "Which records the export covers."
          },
          "status": {
            "type": "string",
            "enum": ["pending", "processing", "completed", "failed"],
            "description": "Where the export has got to. Failed means the export gave up and wrote no file."
          },
          "totalCount": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "How many rows have been written so far, and the final count once the export finishes."
          },
          "filter": {
            "anyOf": [
              {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ],
            "description": "The filter document the export was narrowed to. Null when the export covers every record of its type."
          },
          "search": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The free-text search the export was narrowed to, if there was one."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When the export was started."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
            "description": "When the export last made progress."
          }
        },
        "required": [
          "id",
          "userId",
          "fileUrl",
          "type",
          "status",
          "totalCount",
          "filter",
          "search",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false
      },
      "description": "The page of records, in the requested sort order."
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pass this back as `cursor` to fetch the next page. Null once the last page has been returned."
    }
  },
  "required": ["data", "nextCursor"],
  "additionalProperties": false
}

POST `/export-jobs`

Queue a CSV export of records of one type, optionally narrowed by a filter. It runs in the background, so poll the job until it completes and then download fileUrl. Exports of one type run one at a time: if the same export (same type, filter and search) is already queued or running, its ID is returned rather than a second being queued. Only session-authenticated requests can start one, since an export is attributed to a user.

Requires the exports:write permission.

Costs 10 rate limit tokens instead of the usual one. See Rate limits.

Body parameters

Which records to export.

filterstring

A JSON-encoded filter document, in the same shape the matching list endpoint takes. Only the records it matches are exported. Omit to export every record of this type.

searchstring

A free-text search term, matched the same way the matching list endpoint matches it. Combined with filter using AND.

Request

curl \
  -X POST \
  "https://your-store.meisei.app/api/export-jobs" \
  -H "Authorization: Bearer sk_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "customers",
  "filter": "string",
  "search": "string"
}'

Request

import { client } from "@meisei/api/admin/client"
import { postExportJobs } from "@meisei/api/admin"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
  headers: { Authorization: "Bearer sk_YOUR_SECRET_KEY" },
})

const { data, error } = await postExportJobs({
  body: {
    type: "customers",
    filter: "string",
    search: "string",
  },
})

Request

require "meisei"

meisei = Meisei::Client.new(
  secret_key: "sk_YOUR_SECRET_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.export_jobs.create(
  type: "customers",
  filter: "string",
  search: "string",
)

Request

from meisei import Client

meisei = Client(
    secret_key="sk_YOUR_SECRET_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.export_jobs.create(
    type="customers",
    filter="string",
    search="string",
)

Response

{
  "exportJobId": "A4Ws1igz"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "exportJobId": {
      "type": "string",
      "description": "The ID of the queued export job.",
      "idCodec": "sqid"
    }
  },
  "required": ["exportJobId"],
  "additionalProperties": false,
  "description": "A handle you can poll for progress."
}

GET `/export-jobs/{id}`

Get a single export job by ID. Once its status is completed, fileUrl is a signed link to the CSV.

Requires the exports:read permission.

Path parameters

idstringrequired

The ID of the export job.

Request

curl \
  "https://your-store.meisei.app/api/export-jobs/A4Ws1igz" \
  -H "Authorization: Bearer sk_YOUR_SECRET_KEY"

Request

import { client } from "@meisei/api/admin/client"
import { getExportJobsById } from "@meisei/api/admin"

client.setConfig({
  baseUrl: "https://your-store.meisei.app/api",
  headers: { Authorization: "Bearer sk_YOUR_SECRET_KEY" },
})

const { data, error } = await getExportJobsById({
  path: { id: "A4Ws1igz" },
})

Request

require "meisei"

meisei = Meisei::Client.new(
  secret_key: "sk_YOUR_SECRET_KEY",
  base_url: "https://your-store.meisei.app/api",
)

result = meisei.export_jobs.retrieve("A4Ws1igz")

Request

from meisei import Client

meisei = Client(
    secret_key="sk_YOUR_SECRET_KEY",
    base_url="https://your-store.meisei.app/api",
)

result = meisei.export_jobs.retrieve("A4Ws1igz")

Response

{
  "id": "A4Ws1igz",
  "userId": "uHKNC81a",
  "fileUrl": "string",
  "type": "customers",
  "status": "pending",
  "totalCount": 0,
  "filter": "...",
  "search": "string",
  "createdAt": "2025-01-15T09:30:00Z",
  "updatedAt": "2025-01-15T09:30:00Z"
}

Response schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the export job.",
      "idCodec": "sqid"
    },
    "userId": {
      "type": "string",
      "description": "The ID of the user who started the export.",
      "idCodec": "controlPlane"
    },
    "fileUrl": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "A signed URL to download the finished CSV. Null until the export completes."
    },
    "type": {
      "type": "string",
      "enum": [
        "customers",
        "products",
        "orders",
        "surveys",
        "reviews",
        "wishlists",
        "loyalty-activity",
        "loyalty-members"
      ],
      "description": "Which records the export covers."
    },
    "status": {
      "type": "string",
      "enum": ["pending", "processing", "completed", "failed"],
      "description": "Where the export has got to. Failed means the export gave up and wrote no file."
    },
    "totalCount": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "description": "How many rows have been written so far, and the final count once the export finishes."
    },
    "filter": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ],
      "description": "The filter document the export was narrowed to. Null when the export covers every record of its type."
    },
    "search": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "The free-text search the export was narrowed to, if there was one."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the export was started."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "When the export last made progress."
    }
  },
  "required": [
    "id",
    "userId",
    "fileUrl",
    "type",
    "status",
    "totalCount",
    "filter",
    "search",
    "createdAt",
    "updatedAt"
  ],
  "additionalProperties": false,
  "description": "The requested export job."
}

#Export jobs

GET /export-jobs

Query parameters

POST /export-jobs

Body parameters

GET /export-jobs/{id}

Path parameters

Export jobs

GET `/export-jobs`

POST `/export-jobs`

GET `/export-jobs/{id}`