# Fetch the status of an agent response

GET https://app.credal.ai/api/v1/agents/fetchAgentResponse

Polls for the status and result of a previously sent agent message using the job ID returned by sendMessage. Requires the `api:agent:message:*` scope.

Reference: https://docs.credal.ai/api-reference/v-1/api-reference/agents/fetch-response

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `jobId` (string, required)

## Response

### 200

Agent response status

- `agents_fetchResponse_Response_200`

## Errors

### 400 Bad Request Error

Invalid request

- `any`

### 401 Unauthorized Error

Unauthorized

- `any`

### 403 Forbidden Error

Forbidden

- `any`

### 404 Not Found Error

Job not found

- `any`

### 500 Internal Server Error

Internal server error

- `any`

## Types

### AgentsFetchResponseResponse2000

- `status` (enum, required)
  - Allowed values: `RUNNING`

### AgentsFetchResponseResponse2001

- `status` (enum, required)
  - Allowed values: `COMPLETED`
- `result` (AgentsFetchAgentResponseGetResponsesContentApplicationJsonSchemaOneOf1Result, required)

### AgentsFetchResponseResponse2002

- `status` (enum, required)
  - Allowed values: `FAILED`
- `errorMessage` (string, required)

### AgentsFetchAgentResponseGetResponsesContentApplicationJsonSchemaOneOf1Result

- `agentResponseText` (string, required)

## Examples

**Response**

```json
{
  "status": "COMPLETED",
  "result": {
    "agentResponseText": "Here are the Q4 planning documents I found..."
  }
}
```

**SDK Code**

```typescript
import { CredalClient } from "@credal/sdk";

async function main() {
    const client = new CredalClient({
        token: "YOUR_TOKEN_HERE",
    });
    await client.agents.fetchResponse({
        jobId: "jobId",
    });
}
main();

```

```python
from credal import CredalV1

client = CredalV1(
    token="YOUR_TOKEN_HERE",
)

client.agents.fetch_response(
    job_id="jobId",
)

```

## Related pages

- [API Reference](./api-reference-2-index.md)
- [API Reference](./api-reference-index.md)
- [Credal | Documentation](../index.md)
- [Getting Started](./getting-started-index.md)
- [Platform](./platform-index.md)
- [Agent Builder](./platform-agent-builder.md)
- [Copilots](./api-reference-2-copilots.md)
- [Overview](./api-reference-overview.md)
- [What is Credal?](./getting-started-introduction.md)
- [Quickstart](./getting-started-quickstart.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.