microCMS
Documentation
  • Pricing
  • Blog
  • FAQ
  • Contact
  • Sign In
  • Get started for free
Navigation
Tutorial
Next.js
  • Integration with Next.js
  • Getting Started with App Router
  • Tutorial (App Router)
  • Getting Started with Pages Router
  • Tutorial (Pages Router)
Astro
  • Getting Started
  • Integration with Astro
  • Tutorial
Nuxt
  • Integration with Nuxt
  • Getting Started
  • Tutorial
Gatsby
  • Integration with Gatsby
  • Getting Started
  • Tutorial
JavaScript
  • Integration with JavaScript
  • Getting Started (Browser)
  • Getting Started (Server)
PHP
  • Integration with PHP
  • Getting Started
Ruby
  • Integration with Ruby
  • Getting Started
Go
  • Integration with Go
  • Getting Started with microCMS
Manual
  • Introduction
Account & Login
  • Account Registration
  • Login
  • Email Address Authentication
Services
  • Creating a Service
  • Service Configuration
  • Template
  • Service Deletion
Payment
  • Change of Pricing Plan
  • Registering and Changing Payment Methods
API
  • Creating and Managing APIs
  • API Settings
  • Export/Import of API Schema
Fields
  • Text Field
  • Text Area
  • Image
  • Multiple Images
  • Date
  • Boolean
  • Selectable Field
  • Content Reference
  • Multiple Content References
  • Number
  • File
  • Extended Field
  • Repetition
  • Custom
Contents
  • CSV Export of Content
  • Content Creation
  • Content Editing
  • Content Management
  • View
  • Content Status
  • Custom Status
  • Setting the Content ID
  • Automatically Assigned Values for Content
  • CSV Import of Content
  • API Preview
  • Examples of Using Query Parameters with API Preview
  • Integration Methods by Rendering Type
  • Screen Preview
  • Setting Up Webhooks for Content
Rich Editor
  • How to Use the Rich Editor
  • Rich Editor WRITE API
  • How to Use the Old Rich Editor
Reviews
  • Review
  • AI Review
Media
  • Media Management
  • Changing Media Filters and Display Order
  • Media Tag Configuration
  • Setting Up Media Webhooks
  • Custom Domain Settings for Media
Permission Management
  • Member Management
  • Roles (Permission Management in the Admin Panel)
Environments
  • Multiple Environments (Development Environment)
  • Merging API Settings Between Environments
Connection
  • Amazon S3 Integration
Logs
  • Audit Log
  • Data Transfer Volume
Security
  • Content Update History
  • IP Restrictions for Management Dashboard
  • IP Restrictions for APIs
Authentication
  • Setting Up Two-Factor Authentication
  • Mandatory Two-Factor Authentication
  • Single Sign-On
Specifications & Limitations
  • Recommended Environment
  • Limitations / Precautions
Content API
  • What is the Content API?
Basic Operations
  • GET /api/v1/{endpoint}
  • GET /api/v1/{endpoint}/{content_id}
  • POST /api/v1/{endpoint}
  • PUT /api/v1/{endpoint}/{content_id}
  • PATCH /api/v1/{endpoint}/{content_id}
  • DELETE /api/v1/{endpoint}/{content_id}
API Keys
  • API Key (API Authentication and Authorization Management)
  • Migration from the Old API (X-API-KEY, etc.)
Responses & Error Handling
  • Response format for each field in the GET API
  • Specifying Query Parameters in the GET API
  • Error Responses of the Content API
Management API (Beta)
  • What is the Management API?
Content Operations
  • PUT /api/v1/contents/{endpoint}/{content_id}/reservation
  • GET /api/v1/contents/{endpoint}
  • GET /api/v1/contents/{endpoint}/{content_id}
  • PATCH /api/v1/contents/{endpoint}/{content_id}/status
  • PATCH /api/v1/contents/{endpoint}/{content_id}/createdBy
Media Operations
  • GET /api/v2/media
  • GET /api/v1/media
  • POST /api/v1/media
  • DELETE /api/v2/media
Member Operations
  • GET /api/v1/members
  • GET /api/v1/members/{member_id}
API Operations
  • POST /api/v1/apis
  • GET /api/v1/apis
  • GET /api/v1/apis/{endpoint}
Service Operations
  • GET /api/v1/service
Responses & Error Handling
  • Management API Error Responses
Image API
  • What is the Image API?
Parameters
  • Image Size
  • Quality
  • Resolution and Screen Size
  • Format
  • Text
  • Border
  • Padding
  • Shape
  • Download
  • Watermark
MCP Server
  • microCMS MCP
  • microCMS Document MCP Server
  • Top
  • Content API

Specifying Query Parameters in the GET API

Last updated: 2026/09/02

In the GET API, the following query parameters can be used regardless of the schema structure of the corresponding API.

  • draftKey
  • limit
  • offset
  • q
  • ids
  • depth (applies only to Content Reference and Multiple Content References)
  • richEditorFormat (applies only to Old Rich Text Editor)

On the other hand, the following query parameters are limited to specific fields, and the usage may differ for each field.

  • orders
  • fields
  • filters (equals, not_equals, less_than, greater_than, exists, not_exists, begins_with)

The applicable fields for each query parameter are as follows.

orders

fields

filters
(equals, not_equals)

filters
(contains, not_contains)

filters
(less_than, greater_than)

filters
(exists, not_exists)

filters
(begins_with)

Text Field

◯

◯

◯

◯

-

◯

◯

Text Area

◯

◯

◯

◯

-

◯

◯

Rich Editor

-

◯

-

◯

-

◯

◯(※3)

Old Rich Editor (Deprecated)

-

◯

-

◯

-

◯

◯(※3)

Image

-

◯(※1)

-

-

-

◯

-

Multiple Images

-

◯(※1)

-

-

-

◯

-

Date and Time
(including automatically granted date and time)

◯

◯

◯

◯

◯

◯

◯(※4)

Boolean

-

◯

◯

-

-

◯(※2)

-

Select Field

-

◯

-

◯

-

◯

-

Content Reference
(Field itself)

-

◯

◯

-

-

◯

-

Content Reference
(Referenced Field)

-

◯

-

-

-

-

-

Multiple Content Reference
(Field itself)

-

◯

-

◯

-

◯

-

Multiple Content Reference
(Referenced Field)

-

◯

-

-

-

-

-

Number

◯

◯

◯

-

◯

◯

-

Custom Field
(Field itself)

-

◯

-

-

-

-

-

Custom Field
(Field within Custom Field)

◯

-

◯

◯

◯

◯

◯

Repeating Field
(Field itself)

-

◯

-

-

-

-

-

Repeating Field
(Field within Repeating Field)

◯(※5)

-

-

◯

-

◯

◯

File

-

◯(※1)

-

-

-

◯

-

Extended Field
(Extended Field itself)

-

◯

-

-

-

-

-

Extended Field
(updatedAt Metadata)

◯(※6)

-

◯(※6)

◯(※6)

◯(※6)

◯(※6)

◯(※6)

Extended Field
(Metadata other than updatedAt)

◯(※6)

-

◯(※6)

◯(※6)

-

◯(※6)

◯(※6)

Information
  • Items marked with "-" may be unsupported or have undefined behavior.
  • For fields that allow nested structures, such as content references and Custom Fields, specifying various query parameters for the lower-level fields may result in undefined behavior. Please be aware of this in advance.
  • In "Custom Fields (fields within Custom Fields)" and "Repeating Fields (fields within Repeating Fields)," items marked with "◯" may not be available depending on the field.

Additional Notes

(※1) Keys within images or files (such as url, width, height, etc.) cannot be specified.
(※2) In both cases of true or false, the content is considered to exist.
(※3) This will match the beginning of the string, excluding HTML tags.
(※4) This is a prefix match for the date, not a specification of the start period.
(※5) When multiple custom fields are inserted, the reference values differ for descending and ascending order. For details, please refer to "Order when specifying fields within repeat fields."
(※6) Only the meta information of extended fields can be specified. For details, please refer to "Extended Fields."

Contents

  • Additional Notes
  • Company
  • Legal Notice
  • Terms of Service
  • Privacy Policy

Copyright © microcms.io All rights reserved.