# Amazon CodeGuru Security API > Amazon CodeGuru Security API on Apizie: 13 endpoints (Returns a list of all requested findings., Returns a list of all the standard scans in an account. Does not return express scans., Use to create a scan using code uploaded to an S3 bucket., Generates a pre-signed URL and request headers used to upload a code resource. You can upload your code…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `cloud:amazonaws-codeguru-security` - Category: Cloud - Status: byok - Source: https://github.com/mermade/aws2openapi - Page: https://zieapi.vercel.app/api/cloud/amazonaws-codeguru-security - OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-codeguru-security/openapi.json Amazon CodeGuru Security is in preview release and is subject to change. This section provides documentation for the Amazon CodeGuru Security API operations. CodeGuru Security is a service that uses program analysis… ## Endpoints ### Returns a list of all requested findings. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/batch-get-findings` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | body | object | yes | JSON request body | ### Returns a list of all the standard scans in an account. Does not return express scans. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/list-scans` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | maxResults | integer | no | The maximum number of results to return in the response. Use this parameter when paginating results. If additional results exist beyond… | | nextToken | string | no | A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request.… | ### Use to create a scan using code uploaded to an S3 bucket. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/create-scan` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | body | object | yes | JSON request body | ### Generates a pre-signed URL and request headers used to upload a code resource. You can upload your code… `POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/create-upload-url` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | body | object | yes | JSON request body | ### Use to get account level configuration. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/get-account-configuration` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | ### Returns a list of all findings generated by a particular scan. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/get-findings` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | maxResults | integer | no | The maximum number of results to return in the response. Use this parameter when paginating results. If additional results exist beyond… | | nextToken | string | no | A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request.… | | scanName | string | yes | The name of the scan you want to retrieve findings from. | | status | string | no | The status of the findings you want to get. Pass either Open , Closed , or All . | ### Returns top level metrics about an account from a specified date, including number of open findings, the… `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/get-metrics-summary` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | date | string | yes | The date you want to retrieve summary metrics from, rounded to the nearest day. The date must be within the past two years since metrics… | ### Returns details about a scan, including whether or not a scan has completed. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/get-scan` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | runId | string | no | UUID that identifies the individual scan run you want to view details about. You retrieve this when you call the CreateScan operation.… | | scanName | string | yes | The name of the scan you want to view details about. | ### Returns metrics about all findings in an account within a specified time range. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/list-findings-metrics` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | endDate | string | yes | The end date of the interval which you want to retrieve metrics from. | | maxResults | integer | no | The maximum number of results to return in the response. Use this parameter when paginating results. If additional results exist beyond… | | nextToken | string | no | A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request.… | | startDate | string | yes | The start date of the interval which you want to retrieve metrics from. | ### Returns a list of all tags associated with a scan. `GET https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/list-tags-for-resource` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | resourceArn | string | yes | The ARN of the ScanName object. You can retrieve this ARN by calling ListScans or GetScan . | ### Use to add one or more tags to an existing scan. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/tag-resource` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | resourceArn | string | yes | The ARN of the ScanName object. You can retrieve this ARN by calling ListScans or GetScan . | | body | object | yes | JSON request body | ### Use to remove one or more tags from an existing scan. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/untag-resource` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | resourceArn | string | yes | The ARN of the ScanName object. You can retrieve this ARN by calling ListScans or GetScan . | | tagKeys | array | yes | A list of keys for each tag you want to remove from a scan. | ### Use to update account-level configuration with an encryption key. `POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/update-account-configuration` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | region | string | no | The AWS region | | body | object | yes | JSON request body | ## Example ``` curl "https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/batch-get-findings" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Amazon CodeGuru Security API? Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-codeguru-security/batch-get-findings with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Amazon CodeGuru Security API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon CodeGuru Security itself also needs your own key from amazonaws.com. ### Can AI agents use the Amazon CodeGuru Security API? Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-codeguru-security. ### What is the status of the Amazon CodeGuru Security API? Needs your own provider key (bring your own key)