Skip to content
Vimine for developers
EN

Update the member’s contact and personal details

PATCH
/v1/me
curl --request PATCH \
  --url https://api.vimine.network/v1/me \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "phone": "example", "dob": "2026-04-15", "gender": "M", "birthplace": "example", "birth_country": "example", "codicefiscale": "example", "codicefiscale_confirmed": true, "locale": "it" }'

Writable: phone, gender, locale, and the identification — dob, birthplace, birth_country, codicefiscale. A person is identified by a fiscal code OR by date, place and country of birth; the fiscal code is optional and can be added later. A code is validated and cross-checked against the stored name, the date of birth and the place — the comune for people born in Italy, only the STATE (birth_country) for everybody else; sex is not cross-checked. A code that disagrees answers 422 codicefiscale_mismatch with mismatches, hints (names_swapped) and confirmable: when confirmable is true the person may confirm it is the code on their tessera sanitaria — send codicefiscale_confirmed: true — and codicefiscale_check becomes mismatch_confirmed.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
phone
string
nullable
dob
string format: date
nullable
gender
string
nullable
Allowed values: M F
birthplace

Comune (born in Italy) or city, free text (born abroad)

string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable >= 2 characters <= 2 characters
codicefiscale
string
nullable
codicefiscale_confirmed

Write-only: the person confirms a code that disagrees with their particulars (see confirmable)

boolean
locale

The person’s language; null clears the choice. 422 unsupported for a language the platform does not ship

string
nullable
Allowed values: it en zh-Hans zh-Hant fr es de pt-BR

Responses

Section titled “Responses”

200

Section titled “200”

The updated profile

Media typeapplication/json
object
sub
required

The subject identifier of this person, as in the ID token

string
email
required
string format: email
email_verified
required
boolean
first_name
string
nullable
last_name
string
nullable
phone
string
nullable
dob
string format: date
nullable
gender

Demographic only

string
nullable
Allowed values: M F
birthplace
string
nullable
birth_country

ISO 3166-1 alpha-2

string
nullable
codicefiscale

Optional: a person may have none

string
nullable
codicefiscale_check

How the person is identified. matched: a fiscal code that agrees with their particulars; mismatch_confirmed: a code that disagrees, confirmed by the person; absent: no code — date, place and country of birth identify them; null: not identified yet (they cannot request a membership)

string
nullable
Allowed values: matched mismatch_confirmed absent
locale

The language the person chose for the platform and its mails; null: never chosen — the language of the request, then of the association, applies

string
nullable
Allowed values: it en zh-Hans zh-Hant fr es de pt-BR
updated_at
string format: date-time
nullable
Example
{
  "gender": "M",
  "codicefiscale_check": "matched",
  "locale": "it"
}

400

Section titled “400”

Invalid request

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

401

Section titled “401”

Missing or invalid credentials

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Section titled “403”

Not allowed

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

404

Section titled “404”

Not found

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

422

Section titled “422”

Validation failed (errors[]: invalid_codicefiscale, codicefiscale_mismatch, invalid, age_below_minimum, not_writable)

429

Section titled “429”

Rate limited

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

500

Section titled “500”

Internal error

Media typeapplication/problem+json
object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
code
required
string
request_id
string
errors
Array<object>
object
field
string
code
string
message
string
Examplegenerated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}