# Get remote file mappings

GET /v3/remote-file-mappings

Retrieve all remote file mappings with optional account filtering

Endpoint: GET /v3/remote-file-mappings
Security: API_Key

## Query parameters:

  - `accountId` (integer)
    Filter by account ID
    Example: 123

## Response 200 fields (application/json):

  - `id` (integer, required)
    Simple surrogate key in the database for this RFM config
    Example: 123

  - `name` (string, required)
    A user-supplied name to identify this RFM config
    Example: "Google Analytics Replacement"

  - `fileId` (string,null)
    A string GUID used as the uploaded replacement file's "name" in S3
    Example: "8c59d02b-6ebc-4893-9391-9be26c6d34cc"

  - `fileUrl` (string,null)
    The replacement URL, or else the name of the replacement file before it was uploaded
    Example: "https://example.com/replacement-script.js"

  - `matchType` (string, required)
    Either "regex" or "equals"
    Enum: "equals", "regex"

  - `matchValue` (string, required)
    The request URL to be replaced (or the regex that matches URLs to replace)
    Example: "https://www.google-analytics.com/analytics.js"

  - `accountId` (integer, required)
    Foreign key reference to accounts table. The owner of this RemoteFileMapping
    Example: 343

  - `createdBy` (integer, required)
    Foreign key reference to the users table. Who created this RFM?
    Example: 1362

  - `createdAt` (string, required)
    When this RFM was created
    Example: "2024-01-01T10:15:00.000Z"

  - `updatedBy` (integer, required)
    Foreign key reference to the users table. Who updated this RFM most recently?
    Example: 1362

  - `updatedAt` (string, required)
    When this RFM was last updated
    Example: "2024-01-02T10:15:00.000Z"

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 403 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)