--- title: List source maps description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > RUM --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # List source maps{% #list-source-maps %} {% tab title="v2" %} **Note**: This endpoint is in preview and is subject to change. If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/). | Datadog site | API endpoint | | ----------------- | -------------------------------------------------------- | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/sourcemaps/list | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/sourcemaps/list | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/sourcemaps/list | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/sourcemaps/list | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/sourcemaps/list | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/sourcemaps/list | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/sourcemaps/list | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/sourcemaps/list | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/sourcemaps/list | ### Overview Retrieves a paginated list of source maps. Send filters as query parameters, not in a JSON request body. `mapkind` defaults to `js`. For JavaScript source maps, choose one of the three request shapes below. **Examples:** the following commands use the US1 API host. Replace the host with the API host for your site, and the service, version, debug ID, and cursor with values from your organization. Use `--get` so curl sends the filters in the query string; `-X GET` with `--data-urlencode` sends them in the request body instead. **1. List by service and version** Provide both `filter[service]` and `filter[version]` to search source maps indexed by service and version. Omit `search_by`. **Pagination:** prefer cursor pagination. Omit `page[after]` and `page[number]` on the first request. To get the next page, pass `meta.page.next_cursor` as `page[after]`, keeping the same filters. Continue until `meta.page.has_more_results` is `false`. Do not decode or modify the cursor. Legacy page-number pagination is also supported, starting at `page[number]=1`. ```bash curl -sS --get "https://api.datadoghq.com/api/v2/sourcemaps/list" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ --data-urlencode "mapkind=js" \ --data-urlencode "filter[service]=my-web-service" \ --data-urlencode "filter[version]=1.0.0" \ --data-urlencode "page[size]=10" ``` **2. Find a specific JavaScript debug ID** Provide `filter[debug_id]` with a UUID. Service and version filters are not required. Omit `search_by`. **Pagination:** the lookup returns at most one result, so no pagination is needed. `page[after]` is not supported. ```bash curl -sS --get "https://api.datadoghq.com/api/v2/sourcemaps/list" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ --data-urlencode "mapkind=js" \ --data-urlencode "filter[debug_id]=00000000-0000-4000-8000-000000000001" ``` **3. Browse source maps indexed by debug ID** Set `search_by=debug_id` without specifying a debug ID. Do not send service, version, or filename filters in this mode. **Pagination:** this mode requires cursor pagination; `page[number]` is not supported. Omit `page[after]` on the first request. To get the next page, pass `meta.page.next_cursor` as `page[after]`, keeping the same search mode and filters. Continue until `meta.page.has_more_results` is `false`. Do not decode or modify the cursor. First page: ```bash curl -sS --get "https://api.datadoghq.com/api/v2/sourcemaps/list" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ --data-urlencode "mapkind=js" \ --data-urlencode "search_by=debug_id" \ --data-urlencode "page[size]=10" ``` Next page: ```bash curl -sS --get "https://api.datadoghq.com/api/v2/sourcemaps/list" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" \ --data-urlencode "mapkind=js" \ --data-urlencode "search_by=debug_id" \ --data-urlencode "page[size]=10" \ --data-urlencode "page[after]=" ``` For other map kinds, use `page[number]`, starting at 1. This endpoint requires the `rum_apps_read` permission. ### Arguments #### Query Strings | Name | Type | Description | | ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | search_by | enum | Set to `debug_id` to browse JavaScript source maps indexed by debug ID. Only supported for `mapkind=js`. Omit for service/version searches or a specific `filter[debug_id]` lookup. In debug-ID browse mode, service, version, and filename filters are not supported. Allowed enum values: `debug_id` | | mapkind | enum | The type of source map. Defaults to `js`. Allowed enum values: `js, jvm, ios, react, flutter, elf, ndk, il2cpp` | | page[after] | string | Cursor for the next page of a JavaScript listing. Use the value from `meta.page.next_cursor` and keep the same search mode and filters. Omit on the first request. Not supported for other map kinds or for a specific `filter[debug_id]` lookup without `search_by=debug_id`. | | page[size] | integer | The number of results per page. Defaults to 100. Must be at least 1; values above 1000 are capped at 1000. | | page[number] | integer | Legacy page number, starting from 1. Prefer `page[after]` for JavaScript listings. Not supported with `search_by=debug_id`. Other map kinds default to page 1 when pagination parameters are omitted. | | filter[service] | array | Filter by service names (multiple values allowed). Required for `jvm`, `react`, and `flutter` map kinds. Also required for `js` unless searching by `filter[debug_id]` or browsing with `search_by=debug_id`. | | filter[version] | array | Filter by version values (multiple values allowed). Required for `jvm`, `react`, and `flutter` map kinds. Also required for `js` unless searching by `filter[debug_id]` or browsing with `search_by=debug_id`. | | filter[variant] | array | Filter by variant values (multiple values allowed). Supported for `jvm`. | | filter[id] | array | Filter by source map ID values (multiple values allowed). Supported for all map kinds. | | filter[build_id] | array | Filter by build ID values (multiple values allowed). Supported for `jvm`, `ndk`, and `il2cpp`. | | filter[uuid] | array | Filter by UUID values (multiple values allowed). Supported for `ios`. | | filter[platform] | array | Filter by platform values (multiple values allowed). Supported for `react`. | | filter[build_number] | array | Filter by build number values (multiple values allowed). Supported for `react`. | | filter[bundle_name] | array | Filter by bundle name values (multiple values allowed). Supported for `react`. | | filter[arch] | array | Filter by architecture values (multiple values allowed). Supported for `flutter`, `elf`, and `ndk`. | | filter[symbol_source] | array | Filter by symbol source values (multiple values allowed). Supported for `elf`. | | filter[origin] | array | Filter by origin values (multiple values allowed). Supported for `elf`. | | filter[origin_version] | array | Filter by origin version values (multiple values allowed). Supported for `elf`. | | filter[filename] | string | Filter by filename (single value). Supported for `js`, `elf`, and `ndk`. | | filter[debug_id] | string | Filter by a single debug ID in UUID format. Supported for `js` and `react`. For `js`, the lookup returns at most one result and does not require service/version filters. For `react`, service/version filters remain required. | | filter[gnu_build_id] | string | Filter by GNU build ID (single value). Supported for `elf`. | | filter[go_build_id] | string | Filter by Go build ID (single value). Supported for `elf`. | | filter[file_hash] | string | Filter by file hash (single value). Supported for `elf`. | ### Response {% tab title="200" %} OK {% tab title="Model" %} Response containing a paginated list of source maps. | Parent field | Field | Type | Description | | ------------ | -------------------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | [ ] | List of source map data objects. | | data | Object 1 | object | JavaScript source map data object. | | Object 1 | attributes [*required*] | object | Attributes of a JavaScript source map. | | attributes | absolute_path | string | The absolute path to the minified JavaScript file. | | attributes | blob_storage_sourcemap_path | string | The path to the source map in blob storage. | | attributes | build_id | string | The build identifier. | | attributes | created_at [*required*] | date-time | The timestamp when the source map was created. | | attributes | debug_id | string | The debug identifier (UUID format) that uniquely identifies this JavaScript source map. Returned for source maps indexed by debug ID. | | attributes | domain | string | The domain associated with the source map. | | attributes | file_name | string | The file name of the minified JavaScript file. | | attributes | mapkind [*required*] | enum | The type of source map. Always `js` for JavaScript source maps. Allowed enum values: `js` | | attributes | service | string | The service name associated with the source map. | | attributes | size [*required*] | int64 | The size of the source map file in bytes. | | attributes | variant | string | The source map variant. | | attributes | version | string | The version of the service associated with the source map. | | attributes | version_code | string | The version code. | | Object 1 | id [*required*] | string | The unique identifier of the source map. | | Object 1 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 2 | object | React Native source map data object. | | Object 2 | attributes [*required*] | object | Attributes of a React Native source map. | | attributes | build_number | string | The build number. | | attributes | bundle_name | string | The bundle name. | | attributes | bundle_version | string | The bundle version. | | attributes | created_at [*required*] | date-time | The timestamp when the source map was created. | | attributes | debug_id | string | The debug identifier (UUID format). | | attributes | mapkind [*required*] | enum | The type of source map. Always `react` for React Native source maps. Allowed enum values: `react` | | attributes | platform | string | The platform the source map was built for (e.g., `ios`, `android`). | | attributes | service | string | The service name associated with the source map. | | attributes | size [*required*] | int64 | The size of the source map file in bytes. | | attributes | version | string | The version of the service associated with the source map. | | Object 2 | id [*required*] | string | The unique identifier of the source map. | | Object 2 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 3 | object | iOS dSYM source map data object. | | Object 3 | attributes [*required*] | object | Attributes of an iOS dSYM source map. | | attributes | created_at [*required*] | date-time | The timestamp when the source map was created. | | attributes | mapkind [*required*] | enum | The type of source map. Always `ios` for iOS dSYM source maps. Allowed enum values: `ios` | | attributes | size [*required*] | int64 | The size of the dSYM file in bytes. | | attributes | uuids | string | The UUID(s) associated with the dSYM file. | | Object 3 | id [*required*] | string | The unique identifier of the source map. | | Object 3 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 4 | object | JVM (ProGuard/R8) mapping file data object. | | Object 4 | attributes [*required*] | object | Attributes of a JVM mapping file. | | attributes | build_id | string | The build identifier (UUID format). | | attributes | created_at [*required*] | date-time | The timestamp when the mapping file was created. | | attributes | mapkind [*required*] | enum | The type of source map. Always `jvm` for JVM source maps. Allowed enum values: `jvm` | | attributes | service | string | The service name associated with the mapping file. | | attributes | size [*required*] | int64 | The size of the mapping file in bytes. | | attributes | variant | string | The build variant (e.g., `release`, `debug`). | | attributes | version | string | The version of the service associated with the mapping file. | | attributes | version_code | string | The version code. | | Object 4 | id [*required*] | string | The unique identifier of the source map. | | Object 4 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 5 | object | Flutter symbol file data object. | | Object 5 | attributes [*required*] | object | Attributes of a Flutter symbol file. | | attributes | arch | string | The target CPU architecture. | | attributes | created_at [*required*] | date-time | The timestamp when the symbol file was created. | | attributes | mapkind [*required*] | enum | The type of source map. Always `flutter` for Flutter source maps. Allowed enum values: `flutter` | | attributes | service | string | The service name associated with the symbol file. | | attributes | size [*required*] | int64 | The size of the symbol file in bytes. | | attributes | variant | string | The build variant. | | attributes | version | string | The version of the service associated with the symbol file. | | Object 5 | id [*required*] | string | The unique identifier of the source map. | | Object 5 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 6 | object | ELF symbol file data object. | | Object 6 | attributes [*required*] | object | Attributes of an ELF symbol file. | | attributes | arch | string | The target CPU architecture. | | attributes | created_at [*required*] | date-time | The timestamp when the symbol file was created. | | attributes | file_hash | string | The SHA256 hash of the ELF file. | | attributes | file_name | string | The ELF file name. | | attributes | gnu_build_id | string | The GNU build ID (UUID format). | | attributes | go_build_id | string | The Go build ID (UUID format). | | attributes | mapkind [*required*] | enum | The type of source map. Always `elf` for ELF source maps. Allowed enum values: `elf` | | attributes | origin | string | The origin of the ELF file. | | attributes | origin_version | string | The version of the origin package. | | attributes | size [*required*] | int64 | The size of the ELF file in bytes. | | attributes | symbol_source | string | The source of the debug symbols. | | Object 6 | id [*required*] | string | The unique identifier of the source map. | | Object 6 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 7 | object | Android NDK symbol file data object. | | Object 7 | attributes [*required*] | object | Attributes of an Android NDK symbol file. | | attributes | arch | string | The target CPU architecture. | | attributes | build_id | string | The build identifier (UUID format). | | attributes | created_at [*required*] | date-time | The timestamp when the symbol file was created. | | attributes | file_name | string | The NDK library file name. | | attributes | mapkind [*required*] | enum | The type of source map. Always `ndk` for Android NDK source maps. Allowed enum values: `ndk` | | attributes | size [*required*] | int64 | The size of the symbol file in bytes. | | Object 7 | id [*required*] | string | The unique identifier of the source map. | | Object 7 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 8 | object | IL2CPP mapping file data object. | | Object 8 | attributes [*required*] | object | Attributes of an IL2CPP mapping file. | | attributes | build_id | string | The build identifier (UUID format). | | attributes | created_at [*required*] | date-time | The timestamp when the mapping file was created. | | attributes | mapkind [*required*] | enum | The type of source map. Always `il2cpp` for IL2CPP source maps. Allowed enum values: `il2cpp` | | attributes | size [*required*] | int64 | The size of the mapping file in bytes. | | Object 8 | id [*required*] | string | The unique identifier of the source map. | | Object 8 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 9 | object | WebAssembly symbol file data object. | | Object 9 | attributes [*required*] | object | Attributes of a WebAssembly symbol file. | | attributes | build_id | string | The build identifier. | | attributes | created_at | date-time | The timestamp when the symbol file was created. | | attributes | file_name | string | The file name of the symbol file. | | attributes | mapkind [*required*] | enum | The type of source map. Always `wasm` for WebAssembly symbol files. Allowed enum values: `wasm` | | attributes | size | int64 | The size of the symbol file in bytes. | | Object 9 | id [*required*] | string | The unique identifier of the source map. | | Object 9 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | data | Object 10 | object | Portable PDB file data object. | | Object 10 | attributes [*required*] | object | Attributes of a Portable PDB file. | | attributes | build_id | string | The build identifier. | | attributes | created_at | date-time | The timestamp when the symbol file was created. | | attributes | file_name | string | The file name of the symbol file. | | attributes | mapkind [*required*] | enum | The type of source map. Always `portable_pdb` for Portable PDB files. Allowed enum values: `portable_pdb` | | attributes | size | int64 | The size of the symbol file in bytes. | | Object 10 | id [*required*] | string | The unique identifier of the source map. | | Object 10 | type [*required*] | enum | The resource type for source map objects. Allowed enum values: `sourcemaps` | | | meta | object | Pagination metadata for the source maps list response. | | meta | page [*required*] | object | Page information for the source maps list response. | | page | has_more_results [*required*] | boolean | Whether there are more results available beyond the current page. | | page | next_cursor | string | Cursor for the next page of a JavaScript cursor-based listing. Pass this value as `page[after]` with the same search mode and filters. Only returned when another page is available. | | page | total_filtered_count [*required*] | int64 | Total number of matching source maps for legacy page-number pagination. Cursor-based listings do not compute a total; this field may be zero even when records are returned. Use `has_more_results` to continue. | {% /tab %} {% tab title="Example" %} ```json { "data": [ { "attributes": { "absolute_path": "/js/bundle.min.js", "blob_storage_sourcemap_path": "org123/1.0.0/bundle.min.js.map", "build_id": "abc123", "created_at": "2024-01-01T00:00:00Z", "debug_id": "00000000-0000-4000-8000-000000000001", "domain": "example.com", "file_name": "bundle.min.js", "mapkind": "js", "service": "my-web-service", "size": 1024, "variant": "release", "version": "1.0.0", "version_code": "100" }, "id": "5", "type": "sourcemaps" } ], "meta": { "page": { "has_more_results": false, "next_cursor": "string", "total_filtered_count": 100 } } } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Parent field | Field | Type | Description | | ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- | | | errors [*required*] | [object] | A list of errors. | | errors | detail | string | A human-readable explanation specific to this occurrence of the error. | | errors | meta | object | Non-standard meta-information about the error | | errors | source | object | References to the source of the error. | | source | header | string | A string indicating the name of a single request header which caused the error. | | source | parameter | string | A string indicating which URI query parameter caused the error. | | source | pointer | string | A JSON pointer to the value in the request document that caused the error. | | errors | status | string | Status code of the response. | | errors | title | string | Short human-readable summary of the error. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "detail": "Missing required attribute in body", "meta": {}, "source": { "header": "Authorization", "parameter": "limit", "pointer": "/data/attributes/title" }, "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tab %} {% tab title="413" %} Request Entity Too Large {% tab title="Model" %} API error response. | Parent field | Field | Type | Description | | ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- | | | errors [*required*] | [object] | A list of errors. | | errors | detail | string | A human-readable explanation specific to this occurrence of the error. | | errors | meta | object | Non-standard meta-information about the error | | errors | source | object | References to the source of the error. | | source | header | string | A string indicating the name of a single request header which caused the error. | | source | parameter | string | A string indicating which URI query parameter caused the error. | | source | pointer | string | A JSON pointer to the value in the request document that caused the error. | | errors | status | string | Status code of the response. | | errors | title | string | Short human-readable summary of the error. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "detail": "Missing required attribute in body", "meta": {}, "source": { "header": "Authorization", "parameter": "limit", "pointer": "/data/attributes/title" }, "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="500" %} Internal Server Error {% tab title="Model" %} API error response. | Parent field | Field | Type | Description | | ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- | | | errors [*required*] | [object] | A list of errors. | | errors | detail | string | A human-readable explanation specific to this occurrence of the error. | | errors | meta | object | Non-standard meta-information about the error | | errors | source | object | References to the source of the error. | | source | header | string | A string indicating the name of a single request header which caused the error. | | source | parameter | string | A string indicating which URI query parameter caused the error. | | source | pointer | string | A JSON pointer to the value in the request document that caused the error. | | errors | status | string | Status code of the response. | | errors | title | string | Short human-readable summary of the error. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "detail": "Missing required attribute in body", "meta": {}, "source": { "header": "Authorization", "parameter": "limit", "pointer": "/data/attributes/title" }, "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Required query arguments export search_by="debug_id" \# Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/sourcemaps/list?search_by=${search_by}" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" {% /tab %}