Get All Users

GET /users

Get All Users

cURL

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

200

{
  "users": [
    {
      "id_user": 123,
      "first_name": "<string>",
      "last_name": "<string>",
      "email": "<string>",
      "password": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "birth_date": "<string>",
      "street": "<string>",
      "postal_code": "<string>",
      "city": "<string>",
      "country": "<string>",
      "biography": "<string>",
      "job": {},
      "portfolio": "<string>",
      "youtube": "<string>",
      "instagram": "<string>",
      "linkedin": "<string>",
      "facebook": "<string>",
      "tiktok": "<string>",
      "known_by_mars_ai": {},
      "role": {},
      "createdAt": {},
      "updatedAt": {}
    }
  ]
}

Authentication Required: Bearer token
Role Required: ADMIN

Retrieves a list of all registered users in the platform. This endpoint is restricted to administrators only.

Authentication

This endpoint requires a valid JWT Bearer token with ADMIN role.

Authorization: Bearer <your_jwt_token>

Request

No parameters required.

cURL Example

curl -X GET https://api.marsai.com/users \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Response

users · array

Array of user objects

Show User Object

id_user · integer

Unique user identifier

first_name · string · required

User’s first name

last_name · string · required

User’s last name

email · string · required

User’s email address (unique)

password · string · required

Hashed password (bcrypt)

phone · string

Landline phone number

mobile · string

Mobile phone number

birth_date · date

Date of birth

street · string

Street address

postal_code · string

Postal code

city · string

City

country · string

Country

biography · string

Professional biography

job · enum

Professional role: ACTOR, DIRECTOR, PRODUCER, WRITER, OTHER

portfolio · string

Portfolio URL

youtube · string

YouTube profile

instagram · string

Instagram handle

linkedin · string

LinkedIn profile

facebook · string

Facebook profile

tiktok · string

TikTok handle

known_by_mars_ai · enum

How user discovered MarsAI: Par un ami, Vu une publicité du festival, Via le site internet ou application de l'IA

role · enum · required

User role: ADMIN, JURY, PRODUCER (default: PRODUCER)

createdAt · datetime

Timestamp of user creation

updatedAt · datetime

Timestamp of last update

Success Response

200 OK

[
  {
    "id_user": 1,
    "first_name": "Alice",
    "last_name": "Martin",
    "email": "[e-mail]",
    "password": "$2b$10$XYZ...",
    "phone": "[phone]",
    "mobile": "[phone]",
    "birth_date": "1990-05-15T00:00:00.000Z",
    "street": "123 Rue de la Paix",
    "postal_code": "75001",
    "city": "Paris",
    "country": "France",
    "biography": "Award-winning independent filmmaker",
    "job": "DIRECTOR",
    "portfolio": "https://alicemartin.com",
    "youtube": "alicemartin",
    "instagram": "@alicemartin",
    "linkedin": "alice-martin",
    "facebook": "alice.martin",
    "tiktok": "@alicemartin",
    "known_by_mars_ai": "Par un ami",
    "role": "PRODUCER",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-15T10:30:00.000Z"
  },
  {
    "id_user": 2,
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "[e-mail]",
    "password": "$2b$10$ABC...",
    "role": "ADMIN",
    "createdAt": "2025-01-10T08:00:00.000Z",
    "updatedAt": "2025-01-10T08:00:00.000Z"
  }
]

Error Responses

401 Unauthorized

{
  "error": "Token invalide ou manquant"
}

403 Forbidden

{
  "error": "Accès interdit. Rôle ADMIN requis."
}