Purpose
GET
/channels/{channel_id}/logsFetch message history from a Discord channel.
- channel_id: Discord channel ID
- limit: Number of messages to retrieve (1-1000)
- before: Get messages before this message ID
- after: Get messages after this message ID
Authentication
Send a tenant API key as Authorization: Bearer <key> or X-API-Key: <key>. Keep keys server-side and use the account slug for the connected Discord account.
Parameters
NameInRequiredType / constraints
channel_id
path
required
integer
limit
query
optional
integer · default 100 · range 1–1000
before
query
optional
integer · default null
after
query
optional
integer · default null
Request example
Replace the tenant, account, and resource placeholders before running this read-only request.
curl --fail-with-body \
-H "Authorization: Bearer ${DATAZ_API_KEY}" \
"https://dataz.md/gateway/v1/{tenant_slug}/accounts/{account_slug}/channels/{channel_id}/logs?limit=100"
Response schema
Documented responses
200Response model: List[Message]List[Message]
Response example
Representative JSON shape. The live response can include additional documented fields.
[
{
"id": "123456789012345678",
"content": "Example message",
"type": 0,
"timestamp": "2026-01-01T00:00:00Z",
"channelId": "123456789012345678",
"author": {
"id": "123456789012345678",
"username": "example_user",
"display_name": "Example User"
}
}
]
Errors
Common responses
401Missing or invalid tenant API key.authentication
403The tenant, account, or connected provider cannot access the requested resource.authorization
404The route or requested provider resource was not found.not found
422A path or query parameter is invalid.validation
429Rate limited; wait for the Retry-After interval before retrying.rate limit
Limits and pagination
- Use
limitto bound each response; it defaults to 100 and accepts 1–1000. - Use
beforeto continue toward older records orafterfor incremental reads; store source IDs as cursors. - Provider or demo limits can return HTTP 429. Wait for the
Retry-Afterinterval before retrying.
Related tutorials
Read-only notes
This reference page documents a public GET endpoint. Setup/token, AI, dev, internal, and mutating routes are excluded from static reference generation.