---
title: "Get Mods"
method: GET
path: "/mods/"
tags: ["WorldBuilder", "public"]
---

# Get Mods

`GET /mods/`

Retrieves a list of mods that the user has access to within an organization or project.
    Only project scoped queries may make paginated requests. Support for organization scoped queries will be removed in a future version.

## Query parameters

- `limit` number
- `startAfter` string
- `endBefore` string
- `orderBy` object[]
  - `field` string, required — Field to order by. Allows nesting with dot notation, e.g. if a field is nested in an object, use 'object.field'
  - `direction` union, required — Direction to order by, either 'asc' (Ascending) or 'desc' (Descending)
    - 'asc'
    - 'desc'
- `searchBy` object
  - `field` string — Field to search by. Allows nesting with dot notation, e.g. if a field is nested in an object, use 'object.field'
  - `prefix` string — Prefix to search for. NOTE: Prefix searching is case sensitive.
- `filterBy` object

## Headers

- `x-m2-organization-id` string, required
- `x-m2-project-id` string

## Response `200`

The relevant mods associated with the organization.

- union — The relevant mods associated with the organization.
  - object
    - `mods` object[], required
      - `modId` string, required — Unique identifier for the mod
      - `name` string, required — Name of the mod
      - `description` string, required — Description of the mod
      - `pictureUrl` string — URL of the mod's picture
      - `liveContentId` string, required — The live content ID associated with the mod
      - `projectId` string, required — The ID of a project
      - `canUserWrite` boolean, required
      - `lastUploadTime` number, required
    - `hasMore` string
  - object[]
    - `modId` string, required — Unique identifier for the mod
    - `name` string, required — Name of the mod
    - `description` string, required — Description of the mod
    - `pictureUrl` string — URL of the mod's picture
    - `liveContentId` string, required — The live content ID associated with the mod
    - `projectId` string, required — The ID of a project
    - `canUserWrite` boolean, required
    - `lastUploadTime` number, required

## Other responses

- `4XX` — The error object returned by the API when an error occurs

---

[API](https://skmtc.net/otherside/apis/world-builder.md) · [All operations](https://skmtc.net/otherside/apis/world-builder/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/otherside/world-builder/revisions/5b916374c3f8/schema)