List Proposals

Retrieve all proposals for the authenticated user, sorted by most recent first.

GET /api/proposals

List Proposals

cURL

curl --request GET \
  --url https://api.example.com/api/proposals

200

{
  "proposals": [
    {
      "id": "<string>",
      "proposalCode": "<string>",
      "title": "<string>",
      "description": "<string>",
      "status": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "user_id": "<string>",
      "user_email": "<string>",
      "user_name": "<string>",
      "uploaded_files": {},
      "text_inputs": {},
      "metadata": {}
    }
  ]
}

Authentication

This endpoint requires authentication via Bearer token.

Authorization: Bearer <token>

Response

proposals · array

Array of proposal objects belonging to the authenticated user.

Show Proposal Object

id · string

Unique proposal identifier (UUID).

proposalCode · string

Human-readable proposal code (format: PROP-YYYYMMDD-XXXX).

title · string

The title of the proposal.

description · string

The description of the proposal.

status · string

Current status of the proposal (e.g., “draft”, “submitted”, “completed”).

created_at · string

ISO 8601 timestamp of when the proposal was created.

updated_at · string

ISO 8601 timestamp of the last update.

user_id · string

The ID of the user who owns the proposal.

user_email · string

The email of the user who owns the proposal.

user_name · string

The name of the user who owns the proposal.

uploaded_files · object

Dictionary of uploaded files organized by category (e.g., “rfp-document”, “concept-document”, “reference-proposals”).

text_inputs · object

Dictionary of text inputs provided by the user.

metadata · object

Additional metadata including analysis results, status flags, and processing information.

Example Request

cURL

curl -X GET https://api.igadregion.org/api/proposals \
  -H "Authorization: Bearer YOUR_TOKEN"

Response Example

{
  "proposals": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "proposalCode": "PROP-20260304-A1B2",
      "title": "Climate Resilience in East Africa",
      "description": "Proposal for improving climate adaptation strategies",
      "status": "draft",
      "created_at": "2026-03-04T10:30:00.000Z",
      "updated_at": "2026-03-04T15:45:00.000Z",
      "user_id": "user_123",
      "user_email": "[e-mail]",
      "user_name": "John Doe",
      "uploaded_files": {
        "rfp-document": ["s3://bucket/PROP-20260304-A1B2/rfp.pdf"],
        "concept-document": ["s3://bucket/PROP-20260304-A1B2/concept.pdf"]
      },
      "text_inputs": {
        "initial-concept": "Brief description of the project concept..."
      },
      "metadata": {
        "rfp_analysis_status": "completed",
        "concept_analysis_status": "processing"
      }
    },
    {
      "id": "b2c3d4e5-f6g7-8901-bcde-fg2345678901",
      "proposalCode": "PROP-20260301-C3D4",
      "title": "Agricultural Development Program",
      "description": "Support for smallholder farmers",
      "status": "submitted",
      "created_at": "2026-03-01T08:00:00.000Z",
      "updated_at": "2026-03-02T12:00:00.000Z",
      "user_id": "user_123",
      "user_email": "[e-mail]",
      "user_name": "John Doe",
      "uploaded_files": {
        "rfp-document": ["s3://bucket/PROP-20260301-C3D4/rfp.pdf"]
      },
      "text_inputs": {},
      "metadata": {
        "rfp_analysis_status": "completed",
        "concept_analysis_status": "completed",
        "template_generation_status": "completed"
      }
    }
  ]
}

Notes

• Sorting: Proposals are returned in reverse chronological order (most recent first) based on the created_at timestamp.
• User Filtering: Only proposals belonging to the authenticated user are returned.
• DynamoDB Keys: Internal DynamoDB keys (PK, SK, GSI1PK, GSI1SK) are filtered out from the response.
• Status Values: Common status values include "draft", "submitted", "completed", and "archived".