---
updatedAt: 2026-09-21T10:34:39.000Z
agentTools:
  projectIndex: https://developers.marq.com/llms.txt
---

# List approvals

Retrieves approvals about requested projects. Requires at least a "read-only" access to the requested project approvals.

**Minimum Required Authorization Scope:** `Project.Content.Approval:readonly`\
**Access Token Required**: [Account or User](https://marq.readme.io/reference/access-token-types#account-tokens)

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "marq-v1",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.marq.com/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://example.com/oauth2/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/approvals": {
      "get": {
        "summary": "List approvals",
        "description": "",
        "operationId": "get-approvals-for-project-account",
        "parameters": [
          {
            "name": "approverId",
            "in": "query",
            "description": "The User ID that is the assigned approver of the project.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "createdBefore",
            "in": "query",
            "description": "Only return statuses that were created before the provided timestamp",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "createdAfter",
            "in": "query",
            "description": "Only return statuses that were created after the provided timestamp",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "[\n    {\n        \"approvalState\": \"pending_approval\",\n        \"requesterId\": 164359417,\n        \"approverId\": 164359412,\n        \"timestamp\": \"2025-01-24T06:34:41Z\",\n        \"approvalTarget\": {\n            \"id\": \"21f5eca7-3011-407e-a799-3e4c51cca1f1\",\n            \"kind\": \"project\"\n        }\n    },\n  {\n        \"approvalState\": \"approved\",\n        \"requesterId\": 164359417,\n        \"approverId\": 164359412,\n        \"timestamp\": \"2025-01-24T06:34:41Z\",\n        \"approvalTarget\": {\n            \"id\": \"93f5eca7-3011-407e-a799-3e4c51cca143\",\n            \"kind\": \"project\"\n        }\n    }\n]"
                  }
                },
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "approvalState": {
                        "type": "string",
                        "example": "pending_approval"
                      },
                      "requesterId": {
                        "type": "integer",
                        "example": 164359417,
                        "default": 0
                      },
                      "approverId": {
                        "type": "integer",
                        "example": 164359412,
                        "default": 0
                      },
                      "timestamp": {
                        "type": "string",
                        "example": "2025-01-24T06:34:41Z"
                      },
                      "approvalTarget": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "21f5eca7-3011-407e-a799-3e4c51cca1f1"
                          },
                          "kind": {
                            "type": "string",
                            "example": "project"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "4XX": {
            "description": "4XX",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"code\": \"accessForbidden\",\n    \"requestId\": \"c8978f0000000kl8\",\n    \"message\": \"Access to this resource is forbidden\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "accessForbidden"
                    },
                    "requestId": {
                      "type": "string",
                      "example": "c8978f0000000kl8"
                    },
                    "message": {
                      "type": "string",
                      "example": "Access to this resource is forbidden"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```