Skip to main content
GET
/
api
/
proposals
List Proposals
curl --request GET \
  --url https://api.example.com/api/proposals
{
  "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.

​
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": "[email protected]",
      "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": "[email protected]",
      "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".

Build docs developers (and LLMs) love

Get started for freeTalk to us