Skip to main content
POST
List sourcemaps

Restrictions

Usage

  • start_time and end_time are required — both use Unix epoch milliseconds and filter by upload time. Maximum window is 365 days.
  • type selects the platform store: browser, android, ios, miniprogram, react-native, harmony, flutter or electron. Defaults to browser when omitted; any other value (including web) returns an empty result.
  • kind: native switches android and harmony to their native .so symbol stores.
  • Default page size is 20; maximum is 100. Default sort is created_at descending.
  • build_id, uuid and query are substring matches. uuid and iOS query values are upper-cased and stripped of hyphens before matching.
  • When nothing matches, both items and total are omitted and data is an empty object.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Paginated filter for sourcemap listings.

end_time
integer<int64>
required

End of upload time range, Unix epoch milliseconds. Maximum window: 365 days.

start_time
integer<int64>
required

Start of upload time range, Unix epoch milliseconds. Must be > 0 and before end_time.

asc
boolean
default:false

Sort ascending. Default false (descending).

build_id
string

Substring filter on the build ID (Android Gradle plugin build identifier, or the build ID of native symbols). Max 200 characters.

Maximum string length: 200
kind
enum<string>

Symbol type filter, Android and HarmonyOS only (ignored for other platforms): mapping (default) lists ProGuard/R8 mappings or ArkTS sourcemaps, native lists native .so symbols.

Available options:
mapping,
native
limit
integer
default:20

Page size. Maximum 100. Default 20.

Required range: x <= 100
Example:

20

orderby
enum<string>

Sort field; defaults to created_at descending when omitted.

Available options:
created_at,
updated_at
p
integer
default:1

Page number, starting at 1.

Required range: x >= 1
Example:

1

query
string

Free-text substring match. Matches minified_url for the JS stores (browser/react-native/harmony/miniprogram), build_id for android/flutter/electron and harmony with kind=native, or uuid for ios (case-insensitive, hyphens ignored).

Maximum string length: 200
services
string[]

Filter by service names. Up to 100 values.

Maximum array length: 100
type
enum<string>

Platform whose symbol store to list. Defaults to browser when omitted; any other value returns an empty list.

Available options:
browser,
android,
ios,
miniprogram,
react-native,
harmony,
flutter,
electron
uuid
string

iOS only. Substring filter on the dSYM UUID; upper-cased and stripped of hyphens before matching. Max 200 characters.

Maximum string length: 200
versions
string[]

Filter by version strings. Up to 100 values.

Maximum array length: 100

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

Paginated list of sourcemap records.