# Post an authority claim for a software statement

**POST /organisations/{OrganisationId}/softwarestatements/{SoftwareStatementId}/authorityclaims**




## Servers
- Raidiam Directory Sandbox Environment: https://matls-api.sandbox.raidiam.io (Raidiam Directory Sandbox Environment)


## Authentication methods
- O auth


## Parameters
### Headers
- **x-fapi-auth-date** (string)
  The time when the PSU last logged in with the TPP. 
  All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: 
  Sun, 10 Sep 2017 19:43:31 UTC
- **x-fapi-customer-ip-address** (string)
  The PSU's IP address if the PSU is currently logged in with the TPP.
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.
- **x-customer-user-agent** (string)
  Indicates the user-agent that the PSU is using.

### Path parameters
- **OrganisationId** (string)
  The organisation ID
- **SoftwareStatementId** (string)
  The software statement ID


### Body: application/json (object)

- **AuthorisationDomain** (string)
  Authorisation domain for the authority
- **OrganisationAuthorisationDomainRoleClaimID** (string(uuid))
  Unique ID associated with an organisation authority domain role claim
- **Role** (string)
  The authorisation domain role name


## Responses
### 201
Authority claim for the given Id
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **AuthorisationDomain** (string)
  Authorisation domain for the authority
- **OrganisationAuthorisationDomainRoleClaimID** (string(uuid))
  Unique ID associated with an organisation authority domain role claim
- **Role** (string)
  The authorisation domain role name
- **Status** (string)
  Current status of this resource
- **AuthorisationDomainName** (string)
  Authorisation Domain Name
- **AuthorisationDomainRoleName** (string)
  The authorisation domain role name
- **AuthorityName** (string)
  Name of the Authority i.e. FCA, etc
- **SoftwareAuthorityClaimId** (string)
  Unique ID associated with the authority claims for a software statement

### 400
Bad Request
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **errors** (array[string])
  Validation Error messages

### 401
Unauthorized
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 403
Forbidden
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 409
Conflict
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 429
Too many requests, maximum capacity reached. Requests are now throttled.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 500
Internal Server Error
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 502
Bad Gateway
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 504
Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.


[Powered by Bump.sh](https://bump.sh)