Groq Chat API is one of 9 APIs that Groq publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Chat. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.
This API exposes
1 operation
across 1 path,
and defines 43 schemas.
It is described by OpenAPI 3.2.0, at version 2.1.
Requests are made against a single base URL, https://api.groq.com.
1 operations1 paths43 schemas1 POST
Metadata
The identity and technical contract details declared by the specification.
Groq Chat API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (apiKey) (api_key).
By default, every request must be authenticated.
Paths & Operations 1
Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.
Chat 1
POST
/openai/v1/chat/completions
Creates a model response for the given chat conversation.
createChatCompletionbody→ 200
Schemas 43
The contract defines 43 schemas that model the data the API accepts and returns. The most detailed are CreateChatCompletionRequest (35 properties), Chart (13 properties), ChartElement (12 properties), CreateChatCompletionResponse (11 properties). Each schema is shown below with its type and property counts.
CreateChatCompletionResponse
object
Represents a chat completion response returned by model, based on the provided input.
11 properties5 required
ChatCompletionRequestFunctionMessage
object
3 properties3 required
XGroqNonStreaming
object
Groq-specific metadata for non-streaming chat completion responses.
4 properties1 required
ChartElement
object
12 properties1 required
ChatCompletionRequestMessageContentPartDocument
object
2 properties2 required
ChatCompletionDocumentSource
The source of the document. Only text and JSON sources are currently supported.
ChatCompletionRequestToolMessage
object
3 properties3 required
ChatCompletionResponseMessage
object
A chat completion message generated by the model.
7 properties2 required
ChatCompletionMessageToolCalls
array
The tool calls generated by the model, such as function calls.
ResponseFormatJsonObject
object
JSON object response format. An older method of generating JSON responses. Using jsonschema is recommended for models that support it. Note that the model will…
1 property1 required
ChatCompletionToolChoiceOption
Controls which (if any) tool is called by the model. none means the model will not call any tool and instead generates a message. auto means the model can pick…
ChatCompletionDocumentSourceJSON
object
A document whose contents are provided inline as JSON data.
2 properties2 required
FunctionCitation
object
A citation referencing the result of a function or tool call.
3 properties3 required
DebugData
object
Debug information including input and output token IDs and strings. Only present when debug=true in the request.
4 properties
ChatCompletionUsageBreakdown
object
Usage statistics for compound AI completion requests.
1 property1 required
ChatCompletionRequestAssistantMessage
object
6 properties1 required
ChatCompletionRequestSystemMessage
object
3 properties2 required
ChatCompletionMessageToolCall
object
3 properties3 required
CreateChatCompletionRequest
object
35 properties2 required
ChatCompletionTokenLogprob
object
4 properties4 required
FunctionObject
object
4 properties1 required
ChatCompletionRequestMessageContentPartText
object
2 properties2 required
ChatCompletionTool
object
2 properties1 required
ChatCompletionDocument
object
A document that can be referenced by the model while generating responses.
2 properties1 required
ChatCompletionRequestMessageContentPart
ChatCompletionRequestMessageContentPartImage
object
2 properties2 required
ResponseFormatJsonSchemaSchema
object
The schema for the response format, described as a JSON Schema object. Learn how to build JSON schemas [here](https://json-schema.org/).
ResponseFormatJsonSchema
object
JSON Schema response format. Used to generate structured JSON responses.
2 properties2 required
CompletionUsage
object
Usage statistics for the completion request.
9 properties3 required
CodeExecutionResult
object
4 properties
BrowserResult
object
4 properties2 required
Chart
object
13 properties2 required
ChatCompletionRequestMessage
ChatCompletionNamedToolChoice
object
Specifies a tool the model should use. Use to force the model to call a specific function.
2 properties2 required
ChatCompletionFunctionCallOption
object
Specifying a particular function via {"name": "myfunction"} forces the model to call that function.
1 property1 required
ChatCompletionRequestUserMessage
object
3 properties2 required
ResponseFormatText
object
Default response format. Used to generate text responses.
1 property1 required
FunctionParameters
object
Function parameters defined as a JSON Schema object. Refer to https://json-schema.org/understanding-json-schema/ for schema documentation.
ChatCompletionFunctions
object
3 properties1 required
ChatCompletionMessageExecutedTools
array
A list of tools that were executed during the chat completion for compound AI systems.
DocumentCitation
object
A citation referencing a specific document that was provided in the request.
3 properties3 required
Annotation
object
An annotation that provides citations or references for content in a message.
3 properties1 required
ChatCompletionDocumentSourceText
object
A document whose contents are provided inline as text.
2 properties2 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Groq Chat API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
