> ## Documentation Index
> Fetch the complete documentation index at: https://dos.dzaleka.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Profiles API

> Access community member skill profiles and talent directory

## GET /api/profiles

Retrieve community member profiles from the talent and skills directory.

### Query Parameters

No query parameters required. Returns all profiles.

### Response Format

<ResponseField name="status" type="string" required>
  Status of the API response ("success" or "error")
</ResponseField>

<ResponseField name="count" type="number" required>
  Total number of profiles returned
</ResponseField>

<ResponseField name="data" type="object" required>
  Container for the profiles data

  <ResponseField name="profiles" type="array" required>
    Array of profile objects

    <ResponseField name="id" type="string">
      Unique profile identifier
    </ResponseField>

    <ResponseField name="name" type="string">
      Person's full name
    </ResponseField>

    <ResponseField name="skill" type="string">
      Primary skill or profession
    </ResponseField>

    <ResponseField name="status" type="string">
      Profile status (e.g., "active", "seeking work")
    </ResponseField>

    <ResponseField name="location" type="string">
      Location within Dzaleka
    </ResponseField>

    <ResponseField name="category" type="string">
      Skill category
    </ResponseField>

    <ResponseField name="level" type="string">
      Experience level (beginner, intermediate, expert)
    </ResponseField>

    <ResponseField name="profileImage" type="string">
      URL to profile image
    </ResponseField>

    <ResponseField name="email" type="string">
      Contact email
    </ResponseField>

    <ResponseField name="phone" type="string">
      Contact phone number
    </ResponseField>

    <ResponseField name="shortDescription" type="string">
      Brief profile description
    </ResponseField>
  </ResponseField>
</ResponseField>

### Example Request

```bash theme={null}
curl https://services.dzaleka.com/api/profiles
```

### Example Response

```json theme={null}
{
  "status": "success",
  "count": 42,
  "data": {
    "profiles": [
      {
        "id": "john-web-developer",
        "name": "John Doe",
        "skill": "Web Developer",
        "status": "Available for work",
        "location": "Zone A",
        "category": "Technology",
        "level": "Intermediate",
        "profileImage": "/images/profiles/john.jpg",
        "email": "john@example.com",
        "phone": "+265 123 456 789",
        "shortDescription": "Full-stack developer with 3 years experience in React and Node.js"
      }
    ]
  }
}
```

## POST /api/profiles

Submit profile data with optional metadata.

### Headers

* `Content-Type: application/json` (required)

### Request Body

<ParamField path="metadata" type="object">
  Optional metadata about the request context
</ParamField>

### Response

Returns the same format as GET with additional metadata if provided.

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Talents API" icon="star" href="/api/talents">
    Browse talent groups and categories
  </Card>

  <Card title="Jobs API" icon="briefcase" href="/api/jobs">
    View employment opportunities
  </Card>
</CardGroup>